简介

一种模型上下文协议服务器，允许对XMind思维导图进行智能分析和查询，提供跨XMind文件搜索、提取和分析内容的能力。

简介

一种模型上下文协议服务器，允许对XMind思维导图进行智能分析和查询，提供跨XMind文件搜索、提取和分析内容的能力。

MCP XMind Server

这是一个用于分析和查询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 Inspector

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

来源

• 来源：github
• 链接：https://github.com/apeyroux/mcp-xmind