Cursor XMind MCP

在 Cursor 中通过 MCP 调用本地 XMind，根据需求描述自动生成思维导图并在 Windows 上打开。

功能

| 工具 | 说明 | | --- | --- | | xmind_generate | 根据结构化主题树生成 .xmind 并自动打开 | | xmind_generate_from_outline | 从 Markdown/缩进大纲快速生成脑图 | | xmind_open | 打开已有 .xmind 文件 | | xmind_launch | 仅启动 XMind 桌面应用 | | xmind_read | 读取现有脑图结构（返回大纲） | | xmind_get_config | 查看输出目录、XMind 路径等配置 |

环境要求

• Node.js ≥ 18
• XMind 桌面版（官网下载）
• Cursor（支持 MCP 的版本）

安装（推荐：npm + npx）

发布到 npm 后，无需 clone 仓库、无需绝对路径：

{
  "mcpServers": {
    "xmind": {
      "command": "npx",
      "args": ["-y", "cursor-xmind-mcp"],
      "env": {
        "XMIND_AUTO_OPEN": "true"
      }
    }
  }
}

配置写入项目 .cursor/mcp.json 或全局 %USERPROFILE%\.cursor\mcp.json，保存后重启 Cursor。

验证：在对话中让 AI 调用 xmind_get_config。

发布到 npm（维护者）

若本机 npm config get registry 为 registry.npmmirror.com 等镜像，npm publish 会报 ENEEDAUTH（镜像只读、不能发布）。请在 xmind-mcp 目录使用官方源：

cd xmind-mcp

# 首次：在官方 registry 登录（会打开浏览器或提示输入账号）
npm login --registry https://registry.npmjs.org

# 发布（本目录 .npmrc 已指向 registry.npmjs.org）
npm run publish:npm

未配置包内 .npmrc 时也可：npm publish --registry https://registry.npmjs.org

prepublishOnly 会自动执行 npm run build，将 dist/ 打入发布包。日常 npm install 仍可继续用全局镜像加速。

若发布报 403 ... Two-factor authentication ... is required：

1. 打开 https://www.npmjs.com → 头像 → Account → 启用 2FA（选 Authorization and writes，发布需要写权限）。
2. 重新登录：npm login --registry https://registry.npmjs.org
3. 再执行 npm run publish:npm，按提示输入 OTP 一次性验证码（来自 Authenticator App）。

或使用 Granular Access Token（适合 CI）：npm 网站 → Access Tokens → Generate → 勾选 Publish → 生成后：

npm login --registry https://registry.npmjs.org
# Username: 你的 npm 用户名
# Password: 粘贴 token（不是账号密码）
# Email: 你的邮箱

安装（仓库内 / 团队开发）

在 qiuxiang 根目录执行 npm install 时，postinstall 会自动安装并编译 xmind-mcp/（prepare → tsc）。

手动步骤：

cd xmind-mcp
npm install
npm run build

本地 MCP 配置见 cursor-mcp.example.json（npx 方案）或：

{
  "mcpServers": {
    "xmind": {
      "command": "node",
      "args": ["<本机绝对路径>/xmind-mcp/dist/index.js"],
      "env": {
        "XMIND_AUTO_OPEN": "true"
      }
    }
  }
}

配置项说明

| 环境变量 | 说明 | 默认值 | | --- | --- | --- | | XMIND_OUTPUT_PATH | 生成文件的保存目录 | %USERPROFILE%\Documents\XmindFiles | | XMIND_AUTO_OPEN | 生成后是否自动打开 XMind | true | | XMIND_PATH | XMind.exe 完整路径（找不到时设置） | 自动搜索常见安装位置 |

XMind 常见安装路径（Windows）

• %LOCALAPPDATA%\Programs\XMind\XMind.exe
• C:\Program Files\XMind\XMind.exe

使用示例

配置并重启 Cursor 后，在对话中直接描述需求，例如：

帮我画一个「电商系统架构」思维导图，包含：用户端、订单服务、支付服务、库存服务，每个服务下写 2-3 个核心模块。

Cursor 会调用 xmind_generate 或 xmind_generate_from_outline 生成文件，并自动用 XMind 打开。

排查问题

1. 在 Cursor 中让 AI 调用 xmind_get_config，确认 XMind 路径和输出目录。
2. 若无法自动打开，手动设置 XMIND_PATH 为 XMind.exe 的完整路径。
3. 确认 Node.js 在系统 PATH 中：node -v
4. 修改 MCP 配置后需重启 Cursor 或重新加载 MCP 服务。

开发

npm run dev    # 开发模式（tsx）
npm run build  # 编译 TypeScript
npm start      # 运行 MCP 服务（stdio）

许可证

MIT