Xmind Mind Maps

🚀 MCP XMind 服务器

一个用于分析和查询 XMind 思维导图的 Model Context Protocol 服务器。此工具提供了强大的搜索、提取和分析 XMind 文件内容的功能，能帮助用户高效处理思维导图相关任务。

🚀 快速开始

MCP XMind 服务器可用于分析和查询 XMind 思维导图，提供强大的搜索、提取和分析功能。以下是使用前的安装和启动步骤。

✨ 主要特性

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

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 Claude 桌面版的 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 <允许的目录> [其他目录...]

可用工具

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 dist/index.js",
    "args": ["--development"]
  }
}

生产配置

示例 claude_desktop_config.json 用于生产：

{
  "xmind": {
    "command": "node dist/index.js"
  }
}

安全性

• 安全目录访问：通过限制对指定目录的访问，确保文件操作的安全性。

开发信息

安装依赖项

使用 npm 或 yarn 安装项目依赖：

npm install
# 或者
yarn install

运行测试

运行项目测试：

npm test
# 或者
yarn test

打包

生成生产构建：

npm run build
# 或者
yarn build