Xmind Generator MCP Server

Xmind Generator MCP 服务

一个用于生成 Xmind 思维导图的 MCP（Model Context Protocol）服务。此服务允许大模型通过 MCP 协议创建结构化思维导图。

功能

• 生成具有层级主题结构的 Xmind 思维导图
• 支持主题备注、标签、标记和关系
• 将思维导图保存到本地文件
• 读取现有的 .xmind 文件，并将大纲导出为 Markdown
• 轻松集成 Claude Desktop 和其他 MCP 客户端

前提条件

• Node.js：需要 18 或更高版本
• Xmind：安装 Xmind 桌面应用，以打开和编辑生成的思维导图
• Claude Desktop：需要将此工具用作扩展

在 Claude Desktop 中设置

选项 1：使用 npx（推荐）

1. 创建或编辑 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 添加以下配置：

   {
     "mcpServers": {
       "xmind-generator": {
         "command": "npx",
         "args": ["xmind-generator-mcp"],
         "env": {
           "outputPath": "/path/to/save/xmind/files",
           "autoOpenFile": "false"
         }
       }
     }
   }
   

3. 重启 Claude Desktop

4. 开始在对话中使用 Xmind generator

选项 2：本地安装

1. 克隆仓库：

   git clone https://github.com/BangyiZhang/xmind-generator-mcp.git
   cd xmind-generator-mcp
   npm install
   npm run build
   

2. 创建或编辑 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 添加以下配置：

   {
     "mcpServers": {
       "xmind-generator": {
         "command": "node",
         "args": ["path/to/xmind-generator-mcp/dist/index.js"],
         "env": {
           "outputPath": "/path/to/save/xmind/files",
           "autoOpenFile": "false"
         }
       }
     }
   }
   

4. 将 path/to/xmind-generator-mcp 替换为克隆项目的实际路径

5. 重启 Claude Desktop

6. 开始在对话中使用 Xmind generator

注意：env 部分为可选项，可用于为服务设置环境变量：

• outputPath：保存 Xmind 文件的默认目录或文件路径。可通过工具调用中的 outputPath 参数覆盖此设置。
• autoOpenFile：控制生成的 Xmind 文件是否在创建后自动打开。设置为 "false" 可禁用自动打开（默认为 "true"）。

可用工具

generate-mind-map

根据主题的层级结构生成 Xmind 思维导图。

参数：

• title（string）：思维导图的标题（根主题）
• topics（array）：要包含在思维导图中的主题数组
  • title（string）：主题的标题
  • ref（string，可选）：主题的引用 ID
  • note（string，可选）：主题的备注
  • labels（字符串数组，可选）：主题的标签
  • markers（字符串数组，可选）：主题的标记（格式："Category.name"，例如 "Arrow.refresh"）
  • children（array，可选）：子主题数组
• relationships（array，可选）：主题之间的关系数组
• outputPath（string，可选）：Xmind 文件的自定义输出路径。设置后会覆盖环境变量。

read-mind-map

读取现有的 .xmind 文件，并将其导出为 Markdown 大纲。

参数：

• inputPath（string）：.xmind 文件的路径
• style（string，可选）：Markdown 样式。目前支持 A（大纲）。（B 为未来更丰富的导出格式预留。）

示例：

{
  "inputPath": "/path/to/file.xmind",
  "style": "A"
}

示例

以下是如何使用 generate-mind-map 工具的示例：

{
  "title": "Project Plan",
  "topics": [
    {
      "title": "Research",
      "ref": "topic:research",
      "note": "Gather information about the market",
      "children": [
        {
          "title": "Market Analysis",
          "labels": ["Priority: High"]
        },
        {
          "title": "Competitor Research",
          "markers": ["Task.quarter"]
        }
      ]
    },
    {
      "title": "Development",
      "children": [
        {
          "title": "Frontend",
          "markers": ["Arrow.refresh"]
        },
        {
          "title": "Backend"
        }
      ]
    }
  ]
}

许可证

MIT