MCP XMind 服务器

一个用于分析和查询 XMind 思维导图的模型上下文协议服务器。此工具提供强大的功能，用于搜索、提取和分析 XMind 文件中的内容。

功能

• 🔍 跨思维导图的智能模糊搜索
• 📝 任务管理和跟踪
• 🌲 分层内容导航
• 🔗 链接和引用提取
• 📊 多文件分析
• 🏷️ 标签和标记支持
• 📂 目录扫描
• 🔒 安全目录访问

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 XMind Server：

npx -y @smithery/cli install @41px/mcp-xmind --client claude

手动安装

npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node

用法

启动服务器

node dist/index.js <allowed-directory> [additional-directories...]

可用工具

1. read_xmind

   • 解析和分析 XMind 文件
   • 提取完整的思维导图结构

2. get_todo_tasks

   • 提取和分析 TODO 任务
   • 包括任务上下文和层次结构

3. list_xmind_directory

   • 递归扫描 XMind 文件
   • 过滤和组织结果

4. read_multiple_xmind_files

   • 同时处理多个文件
   • 跨文件比较和分析

5. search_xmind_files

   • 按名称模式搜索文件
   • 递归目录扫描

6. extract_node

   • 智能模糊路径匹配
   • 排名搜索结果
   • 完整子树提取

7. extract_node_by_id

   • 通过 ID 直接访问节点
   • 快速精确的检索

8. search_nodes

   • 多标准内容搜索
   • 可配置的搜索字段

示例

搜索节点

{
    "name": "search_nodes",
    "arguments": {
        "path": "/path/to/file.xmind",
        "query": "project",
        "searchIn": ["title", "notes"],
        "caseSensitive": false
    }
}

提取节点

{
    "name": "extract_node",
    "arguments": {
        "path": "/path/to/file.xmind",
        "searchQuery": "Feature > API"
    }
}

列出任务

{
    "name": "get_todo_tasks",
    "arguments": {
        "path": "/path/to/file.xmind"
    }
}

配置

开发配置

用于开发的 claude_desktop_config.json 示例：

{
  "xmind": {
    "command": "node",
    "args": [
      "/Users/alex/Src/mcp-xmind/dist/index.js",
      "/Users/alex/XMind"
    ]
  }
}

生产配置

使用 npmjs 的生产环境 claude_desktop_config.json 示例：

{
  "xmind": {
    "command": "npx",
    "args": [
      "-y",
      "@41px/mcp-xmind",
      "/Users/alex/XMind"
    ]
  }
}

安全

• 仅允许访问指定的目录
• 路径规范化和验证
• 无效访问尝试的错误处理

开发

构建

npm run build

类型检查

npm run type-check

MCP 检查器

npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind