JinDaGe - XMind Mind Maps MCP Details

article

README

🚀 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 <允许的目录> [其他目录...]

可用工具

read_xmind
- 解析和分析 XMind 文件
- 提取完整的思维导图结构
get_todo_tasks
- 提取并分析 TODO 任务
- 包含任务上下文和层次结构
list_xmind_directory
- 递归扫描 XMind 文件
- 过滤和组织结果
read_multiple_xmind_files
- 同时处理多个文件
- 比较和分析文件之间的内容
search_xmind_files
- 根据名称模式搜索文件
- 递归目录扫描
extract_node
- 智能模糊路径匹配
- 排名搜索结果
- 完整子树提取
extract_node_by_id
- 直接通过 ID 访问节点
- 快速精确检索
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

XMind Mind Maps