金大哥 - xmind-generator-mcp MCP 详情

article

README

🚀 XMind 生成器 MCP 服务器

XMind 生成器 MCP 服务器借助 MCP（模型上下文协议），可生成 XMind 思维导图。它允许大语言模型 (LLMs) 通过 MCP 协议创建结构化的思维导图，为用户提供便捷的思维导图生成体验。

🚀 快速开始

XMind 生成器 MCP 服务器允许大语言模型 (LLMs) 通过 MCP 协议创建结构化的思维导图。以下是使用该服务器的相关信息。

✨ 主要特性

层次结构生成：生成具有层次结构的主题的 XMind 思维导图。
丰富元素支持：支持主题笔记、标签和标记。
本地保存功能：将思维导图保存到本地文件。
便捷集成使用：集成方便，可与 Claude 桌面和其他 MCP 客户端一起使用。

📦 安装指南

先决条件

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

使用 Claude Desktop 设置

选项 1：使用 npx（推荐）

创建或编辑 Claude Desktop 配置文件：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
添加以下配置：

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

重启 Claude Desktop。
开始在对话中使用 XMind 生成器。

选项 2：本地安装

克隆仓库：

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

创建或编辑 Claude Desktop 配置文件：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
添加以下配置：

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

将 path/to/xmind-generator-mcp 替换为您实际克隆项目的路径。
重启 Claude Desktop。
开始在对话中使用 XMind 生成器。

⚠️ 重要提示

env 部分是可选的。它允许您为服务器设置环境变量：

outputPath：指定输出文件夹的位置，默认为 ./xmind_output。

autoOpenFile：控制是否自动打开生成的思维导图，值为 "true" 或 "false"。

💻 使用示例

可用工具 - generate-mind-map

描述

生成一个 XMind 思维导图。

参数

| 属性 | 详情 | |------|------| | 参数名 | content | | 类型 | string | | 是否必填 | 是 | | 描述 | 要生成的内容，使用 JSON 格式定义思维导图的结构和内容。 |

示例

{
    "title": "我的第一个 XMind 思维导图",
    "content": {
        "topic": "开始",
        "children": [
            {
                "topic": "步骤 1",
                "notes": "执行第一步操作"
            },
            {
                "topic": "步骤 2",
                "notes": "执行第二步操作",
                "children": [
                    {
                        "topic": "子步骤 2.1",
                        "notes": "详细说明步骤 2 的子步骤"
                    }
                ]
            }
        ]
    }
}

输出

生成的 XMind 文件将保存到您指定的 outputPath 或默认文件夹中。

完整调用示例

npx xmind-generator-mcp --generate-mind-map --content='{
    "title": "项目计划",
    "content": {
        "topic": "项目概述",
        "children": [
            {
                "topic": "目标",
                "notes": "完成产品开发"
            },
            {
                "topic": "时间表",
                "notes": "截止日期：2024-12-31",
                "children": [
                    {
                        "topic": "阶段 1",
                        "notes": "需求分析",
                        "end_date": "2024-01-15"
                    },
                    {
                        "topic": "阶段 2",
                        "notes": "开发",
                        "end_date": "2024-03-15"
                    }
                ]
            }
        ]
    }
}'

📄 许可证

此项目使用 MIT 许可证。

xmind-generator-mcp