🚀 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