🚀 MindManager MCP 服务器
mindm 库的 Model Context Protocol (MCP) 服务器实现，支持在 Windows 和 macOS 系统上与 MindManager 进行交互，为思维导图的操作和管理提供便利。
🚀 快速开始
本服务器基于 Model Context Protocol（MCP）构建，借助 mindm 库提供的接口，可在 Windows 和 macOS 平台上与 MindManager 实现交互。以下是项目的相关信息：
- 徽章：展示在 PyPI 上的版本信息。
- 功能：支持检索思维导图结构、当前选择项等操作。
✨ 主要特性
已实现功能
- 检索当前思维导图的结构。
- 获取 MindManager 中的当前选中主题。
- 获取 MindManager 库文件夹路径。
- 提取思维导图中的定位信息（中心主题和选定子主题）。
计划实现功能
- 创建新的思维导图。
- 添加、删除和修改主题及关联项。
📦 安装指南
安装要求
- Python 版本：需安装 Python 3.10 或更高版本。
- 依赖库：需要
mcp和mindm库的支持。 - MindManager 支持：支持 MindManager 的 Windows 和 macOS 版本。
macOS 系统
# 克隆仓库到本地目录
$ mkdir -p mindmanager-mcp-server && cd $_
$ git clone https://github.com/your-repository.git .
# 创建虚拟环境并安装依赖项
$ python3 -m venv ./.venv
# 激活虚拟环境（macOS/Linux）
$ source ./.venv/bin/activate
# 安装项目依赖
$ pip install --editable .
Windows 系统
# 克隆仓库到本地目录
$ mkdir mindmanager-mcp-server && cd $_
$ git clone https://github.com/your-repository.git .
# 创建虚拟环境并安装依赖项
$ python -m venv ./.venv
# 激活虚拟环境（Windows）
$ .\.\venv\Scripts\activate.bat
# 安装项目依赖
$ pip install --editable .
💻 使用示例
运行 MCP 检查工具
# 启动 MCP 服务器
$ mindm-mcp-server start
配置 Claude Desktop 中的 MCP 服务
方法一：使用本地文件配置
在 Claude Settings 中添加以下内容到 MCP 配置文件：
{
"servers": [
{
"name": "mindmanager",
"host": "localhost",
"port": 12345,
"executable_path": "/path/to/MindManager"
}
]
}
方法二：从包仓库安装模块
在 Claude Settings 中添加以下内容到 MCP 配置文件：
{
"servers": [
{
"name": "mindmanager",
"host": "localhost",
"port": 12345,
"module_path": "mindmanager-mcp-server"
}
]
}
📚 详细文档
MCP 工具
文档交互工具
获取当前思维导图结构获取当前选中主题获取 MindManager 库文件夹路径提取思维导图中的定位信息
序列化工具
将当前思维导图序列化为 Mermaid 格式将当前思维导图序列化为 Markdown 格式将当前思维导图序列化为 JSON 格式
平台支持
- Windows：全面支持主题、备注、图标、图片、标签、链接、关系和 RTF 格式。
- macOS：仅支持主题、备注和关系（功能有限）。
与 Claude 和其他 LLM 集成
此 MCP 服务器可安装到 Claude Desktop 或其他兼容 MCP 的应用程序中，使 LLM 能够：
- 访问思维导图内容。
- 操作思维导图（即将推出）。
- 基于 LLM 生成的内容创建新思维导图（即将推出）。
故障排除
- 确保 MindManager 已启动后再运行服务器。
- 对于 macOS，确保 Claude Desktop 被授权自动化 MindManager。
致谢
该项目基于 mindm 库构建，为 Windows 和 macOS 提供了访问 MindManager 的 Python 接口。它使用 Anthropic 开发的 Model Context Protocol（MCP）SDK。
📄 许可证
本项目采用 MIT 许可证，详细信息请参阅 LICENSE 文件。