Magic Prompt MCP

基于 Model Context Protocol 的工具服务，提供面向 Cursor 的规则管理与对话式辅助工具。

MCP 配置（Cursor 中的 mcp.json）

将以下内容添加到 .cursor/mcp.json 或 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "magic-prompt-mcp": {
      "command": "node",
      "args": [
        "/AI/magicprompt/build/index.js"
      ],
      "env": {
        "PROJECT_ROOT": "/AI/magicprompt",
        "DOC_PATH": "/AI/magicprompt/doc"
      },
      "disabled": false
    }
  }
}

说明：

• PROJECT_ROOT 与 DOC_PATH 为可选默认值，亦可不配，调用工具时显式传参即可。
• 也可以通过 args 传参（需在入口解析 argv）：
  • --projectRoot=/abs/path，--docPath=/abs/path/doc

参数解析优先级

• 显式工具参数 > 环境变量（PROJECT_ROOT、DOC_PATH）> process.cwd()/projectRoot/doc

可用工具

• init_monorepo: 初始化 monorepo 的 cursor rule 规则管理
  • 参数：projectRoot?，docPath?
• auto_rules_distribution: 汇总 doc/.cursor 中的规则文件信息，供模型分析并决定分配
  • 参数：projectRoot?，docPath?
• generate_subproject: 为指定子项目生成 .cursor/rules（自动包含 common，并自动扁平化多余 rules 层）
  • 参数：subProjectName，includeCommon?=true，projectRoot?，docPath?
• sync_to_doc: 将 .cursor 的规则同步到 doc 目录（自动扁平化多余 rules 层）
  • 参数：targetSubProject?，projectRoot?，docPath?
• list_subprojects: 列出 doc 中可用的子项目与文件统计
  • 参数：projectRoot?，docPath?

扁平化与目录规范

• 工具在复制/同步时会自动“跳过”名为 rules 的中间层，并在必要时进行目录规范化，避免出现 doc/rules/.../rules 等冗余结构。

示例调用（在 Cursor 工具面板中）

• init_monorepo

  { "projectRoot": "/AI/magicprompt", "docPath": "/AI/magicprompt/doc" }

• generate_subproject

  { "subProjectName": "web", "includeCommon": true }

• sync_to_doc

  { "targetSubProject": "web" }

构建

yarn build

以上即为在 Cursor 中通过 MCP 使用本工具集的最小说明，不涉及项目工程细节。