AI导哈

思维导图服务

XMind Ultimate MCP Server 是一个为 Claude Code 设计的全功能思维导图服务，支持创建、读取、分析和转换思维导图文件，适用于项目管理、学术规划和软件开发等多种场景。

  • by Genius-Cai
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 Genius-Cai/xmind-ultimate-mcp

使用说明

XMind Ultimate MCP Server

最全功能的 XMind MCP Server，为 Claude Code 打造
The most comprehensive XMind MCP Server for Claude Code

Demo 效果展示

学业规划 Academic Plan (中英对照 Bilingual)

软件开发生命周期 SDLC (Clean Design)

以上导图由 Claude Code + 本 MCP Server 一条命令自动生成，遵循 Skill 中的视觉设计原则。

Both maps generated by Claude Code + this MCP Server in a single command, following visual design principles from the included Skill.

功能 Features

8 个 MCP 工具，覆盖 XMind 全部功能：

# 工具 Tool 功能 Description 状态 Status
1 create_mind_map 全功能创建：主题/边界/关系线/摘要/标注/浮动主题/标记/样式/主题/折叠 ✅ 完整
2 create_from_text 缩进文本 / Markdown → .xmind ✅
3 read_xmind 读取 .xmind 为结构化 JSON / 文本 ✅
4 analyze_xmind 结构分析 + 优化建议 ✅
5 convert_to_xmind JSON / CSV / YAML / Markdown → .xmind ✅
6 translate_xmind 翻译节点标题（通过映射表） ✅
7 export_xmind .xmind → Markdown / JSON ✅
8 list_xmind_files 目录扫描 .xmind 文件 ✅

XMind 功能覆盖 Feature Coverage

功能 Feature 说明 Description
层级主题 Hierarchical Topics 无限嵌套子主题 Unlimited nesting
10 种结构 Structures 思维导图/逻辑图/组织架构/树状图/鱼骨图/时间线/矩阵
边界 Boundaries 可视化分组框，9 种形状 Visual grouping with 9 shapes
关系线 Relationships 任意两主题间的连线 Cross-topic connections
摘要 Summaries 括号汇总同级主题 Bracket summarization
标注 Callouts 补充说明气泡 Annotation bubbles
标记 Markers 优先级/任务/旗帜/星标/表情/箭头/月份/星期 (60+)
标签 Labels 分类标签 Categorization tags
笔记 Notes 富文本注释 Rich text annotations
浮动主题 Floating Topics 独立于层级的主题 Independent positioned topics
样式 Styles 颜色/字体/形状/线条/边框 Full styling
主题预设 Themes default / professional / colorful / dark
折叠 Folding 预折叠分支 Pre-collapse branches
多画布 Multi-sheet 一个文件多张导图 Multiple canvases

快速开始 Quick Start

1. 安装 Install

git clone https://github.com/Genius-Cai/xmind-ultimate-mcp.git
cd xmind-ultimate-mcp
npm install
npm run build

2. 注册 MCP Register MCP

claude mcp add --scope user xmind-ultimate node $(pwd)/dist/index.js

3. 安装 Skill (可选但推荐 Optional but Recommended)

cp skill/xmind.md ~/.claude/skills/xmind.md

Skill 提供 XMind 官方最佳实践指导，包括：

  • 16 个官方功能模块详解 16 feature modules from official docs
  • 场景→结构自动匹配 Scenario → Structure auto-matching
  • 视觉设计原则 Visual Design Principles (基于 XMind 官方博客 + 设计理论)
  • 反模式清单 Anti-patterns checklist
  • 节点组织规则 Node organization rules (7±2 rule)

4. 使用 Usage

在 Claude Code 中直接说：

"帮我做一个项目管理的思维导图"
"Create a mind map for our API architecture"
"把这个 CSV 转成思维导图"

架构 Architecture

xmind-ultimate-mcp/
├── src/
│   ├── index.ts                # MCP Server 入口 Entry point
│   ├── tools/
│   │   ├── create.ts           # create_mind_map (全功能)
│   │   ├── create-from-text.ts # create_from_text
│   │   ├── read.ts             # read_xmind
│   │   ├── analyze.ts          # analyze_xmind
│   │   ├── convert.ts          # convert_to_xmind
│   │   ├── translate.ts        # translate_xmind
│   │   ├── export.ts           # export_xmind
│   │   └── list.ts             # list_xmind_files
│   ├── core/
│   │   ├── xmind-io.ts         # .xmind ZIP 读写 Read/Write
│   │   ├── xmind-enhance.ts    # 主题构建器 Topic/Sheet builder
│   │   ├── types.ts            # TypeScript 类型 Interfaces
│   │   ├── parser.ts           # XMindMark 解析器
│   │   └── utils.ts            # 工具函数
│   └── converters/             # 格式转换器 Format converters
│       ├── markdown.ts
│       ├── word.ts
│       ├── excel.ts
│       ├── csv.ts
│       ├── json.ts
│       └── yaml.ts
├── skill/
│   └── xmind.md                # Claude Code Skill (最佳实践)
├── docs/
│   ├── assets/                 # Demo 截图
│   └── plans/                  # 设计文档
├── package.json
└── tsconfig.json

依赖 Dependencies

包 Package 用途 Purpose
@modelcontextprotocol/sdk MCP 协议 SDK
jszip .xmind ZIP 文件读写
mammoth Word 文档解析
xlsx Excel 文件解析
csv-parse CSV 解析
yaml YAML 解析

Roadmap

  • [ ] convert_to_xmind 接入 Word / Excel converter（代码已写，待接线）
  • [ ] export_xmind 支持 PDF 导出
  • [ ] export_xmind 支持 Word (.docx) 导出
  • [ ] export_xmind 支持图片 (PNG/SVG) 导出
  • [ ] 更多主题预设 More theme presets
  • [ ] XMindMark 语法完整支持
  • [ ] Gantt Chart 集成

License

MIT

相关 MCP