🚀 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 能够：

1. 访问思维导图内容
2. 操作思维导图（即将推出）
3. 基于 LLM 生成的内容创建新思维导图（即将推出）

故障排除

• 确保 MindManager 已启动后再运行服务器。
• 对于 macOS，确保 Claude Desktop 被授权自动化 MindManager。

致谢

该项目基于 mindm 库构建，为 Windows 和 macOS 提供了访问 MindManager 的 Python 接口。它使用 Anthropic 开发的 Model Context Protocol（MCP）SDK。

📄 许可证

MIT 许可证 - 详细信息请参阅 LICENSE 文件