MCP XMind Server

一个用于分析和查询XMind思维导图的Model Context Protocol服务器。此工具提供了强大的搜索、提取和分析XMind文件内容的能力。

特性

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

安装

通过Smithery安装

要通过Smithery自动安装XMind Server for Claude Desktop，请执行以下命令：

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 <允许的目录> [附加目录...]

可用工具

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": "项目",
        "searchIn": ["标题", "笔记"],
        "caseSensitive": false
    }
}

提取节点

{
    "name": "extract_node",
    "arguments": {
        "path": "/path/to/file.xmind",
        "searchQuery": "特性 > 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 Inspector

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