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