
MindManager MCP Server

2025.04.02
1
Python思维导图工具LLM 集成开发效率
MindManager MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,专为 `mindm` 库设计,提供了与 MindManager(Windows 和 macOS 平台上的思维导图软件)交互的标准化接口。该服务允许通过编程方式操作 MindManager 文档、主题、关系等思维导图元素,并支持将思维导图导出为多种格式(如 Mermaid、Markdown、JSON),以便在 LLM(大语言模型)聊天中使用。
View on GitHub
Overview
基本能力
产品定位
MindManager MCP Server 是一个连接 MindManager 思维导图软件与 MCP 协议的桥梁,旨在通过标准化接口增强开发者和 LLM 对 MindManager 的操作能力。
核心功能
- 思维导图结构获取:检索思维导图结构和中心主题。
- 导出功能:将思维导图导出为 Mermaid、Markdown、JSON 格式。
- MindManager 信息获取:获取 MindManager 安装信息和库文件夹路径。
- 当前选择获取:获取 MindManager 中当前选中的主题。
适用场景
- 开发效率工具:通过编程方式操作思维导图,提升开发效率。
- LLM 集成:将思维导图内容集成到 LLM 聊天中,增强上下文理解。
- 跨平台协作:在 Windows 和 macOS 上统一操作 MindManager。
工具列表
- 文档交互工具:
get_mindmap
:获取当前思维导图结构。get_selection
:获取当前选中的主题。get_library_folder
:获取 MindManager 库文件夹路径。get_grounding_information
:提取思维导图中的基础信息(中心主题、选中子主题)。- 序列化工具:
serialize_current_mindmap_to_mermaid
:将当前思维导图序列化为 Mermaid 格式。serialize_current_mindmap_to_markdown
:将当前思维导图序列化为 Markdown 格式。serialize_current_mindmap_to_json
:将当前思维导图序列化为 JSON 对象(带 ID 映射)。
常见问题解答
- MindManager 未运行:确保启动服务前 MindManager 已运行。
- macOS 权限问题:确保允许 Claude Desktop 自动化 MindManager。
使用教程
使用依赖
- Python 3.12 或更高版本。
mcp
包(Model Context Protocol SDK)。mindm
库(包含在项目中)。- MindManager(支持版本:23-)安装在 Windows 或 macOS 上。
安装教程(macOS)
# 克隆仓库(如果从仓库使用)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp
# 创建 Python 虚拟环境
brew install uv # 如需
uv pip install -r pyproject.toml
# 替代方案:手动安装模块
uv add "mcp[cli]"
uv add fastmcp
uv add markdown-it-py
uv add -U --index-url=https://test.pypi.org/simple/ --extra-index-url=https://pypi.org/simple/ mindm mindm-mcp
安装教程(Windows)
# 切换到 DOS 命令提示符
cmd
# 克隆仓库(如果从仓库使用)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp
# 创建 Python 虚拟环境
pip install uv # 如需
uv pip install -r pyproject.toml
# 安装 nodejs
choco install nodejs # 如果已安装 chocolatey。否则通过其他方式安装 nodejs
refreshenv
node -v
npm install -g npx
调试方式
# 运行 MCP 检查器
uv run --with mind --with fastmcp --with markdown-it-py mcp dev mindm_mcp/server.py
Claude Desktop 集成
本地 Python 文件
调整本地文件路径。
{
"mcpServers": {
"mindm (MindManager)": {
"command": "uv",
"args": [
"run",
"--with",
"mindm>=0.0.4.6",
"--with",
"fastmcp",
"--with",
"markdown-it-py",
"/Users/master/git/mindm-mcp/mindm_mcp/server.py"
]
}
}
}
从包仓库安装模块
调整 VIRTUAL_ENV
。
{
"mcpServers": {
"mindm (MindManager)": {
"command": "uv",
"args": [
"run",
"--with",
"mindm>=0.0.4.6",
"--with",
"mindm-mcp>=0.0.1.50",
"--with",
"fastmcp",
"--with",
"markdown-it-py",
"-m",
"mindm_mcp.server"
],
"env": {
"VIRTUAL_ENV": "/Users/master/git/mindm-mcp/.venv"
}
}
}
}
提示:如果 MCP 服务器在 Windows 上未显示锤子图标,关闭 Claude Desktop 并终止所有后台进程。