MCP XMind Server

基本能力

产品定位

MCP XMind Server 是一个专门用于处理 XMind 思维导图文件的服务器，提供内容分析、查询和管理功能。

核心功能

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

适用场景

• 需要从 XMind 文件中提取和分析内容的场景
• 管理思维导图中的任务和待办事项
• 在多文件间进行内容比较和分析
• 快速搜索和定位思维导图中的特定节点

工具列表

1. read_xmind
2. 解析和分析 XMind 文件

3. 提取完整的思维导图结构

4. get_todo_tasks

5. 提取和分析 TODO 任务

6. 包含任务上下文和层次结构

7. list_xmind_directory

8. 递归扫描 XMind 文件

9. 过滤和组织结果

10. read_multiple_xmind_files

11. 同时处理多个文件

12. 跨文件比较和分析

13. search_xmind_files

14. 按名称模式搜索文件

15. 递归目录扫描

16. extract_node

17. 智能模糊路径匹配
18. 排序搜索结果

19. 完整子树提取

20. extract_node_by_id

21. 通过 ID 直接访问节点

22. 快速精确检索

23. search_nodes

24. 多条件内容搜索
25. 可配置的搜索字段

常见问题解答

• 安全特性：只允许访问指定目录，具有路径规范化和验证功能
• 错误处理：对无效访问尝试有错误处理机制

使用教程

使用依赖

npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node

安装教程

通过 Smithery 自动安装:

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...]

MCP 检查器:

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

构建项目:

npm run build

类型检查:

npm run type-check

许可证

None