MindManager MCP 服务器

mindm库的模型上下文协议 (MCP) 服务器实现，提供与 Windows 和 macOS 上的 MindManager 交互的标准化接口。

概述

此服务器允许您通过模型上下文协议 (MCP) 以编程方式与 MindManager 交互，MCP 是一种为 LLM 提供上下文和工具的标准化方式。它利用mindm库来操作 MindManager 文档、主题、关系和其他思维导图元素。

例子：

特征

检索思维导图结构和中心主题
将思维导图导出为 Mermaid、Markdown、JSON 格式，用于 LLM 聊天
获取有关 MindManager 安装和库文件夹的信息
从 MindManager 获取当前选择

计划功能

从序列化数据创建新的思维导图
添加、修改和操作主题和子主题
添加主题之间的关系
为主题添加标签
设置文档背景图像

要求

Python 3.12 或更高版本
mcp包（模型上下文协议 SDK）
mindm库（包含在本项目中）
在 Windows 或 macOS 上安装 MindManager（支持版本：23-）

安装 macOS

# Clone the repository (if you're using it from a repository)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp

# create a virtual environment for Python
brew install uv # if needed
uv pip install -r pyproject.toml

# alternative: manual installation of modules
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

# Change to DOS command prompt
cmd

# Clone the repository (if you're using it from a repository)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp

# create a virtual environment for Python
pip install uv # if needed
uv pip install -r pyproject.toml

# install nodejs
choco install nodejs # if you have chocolatey installed. If not install nodejs otherwise
refreshenv
node -v
npm install -g npx

用法

MCP检查员

# run mcp with inspector
uv run --with mind --with fastmcp --with markdown-it-py mcp dev mindm_mcp/server.py

克劳德桌面

本地 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 并终止所有后台进程。

MCP 工具

服务器通过模型上下文协议公开以下工具：

文档交互

get_mindmap ：从 MindManager 检索当前思维导图结构
get_selection ：检索 MindManager 中当前选定的主题
get_library_folder ：获取 MindManager 库文件夹的路径
get_grounding_information ：从思维导图中提取基础信息（中心主题、选定的子主题）

序列化

serialize_current_mindmap_to_mermaid ：将当前加载的思维导图序列化为美人鱼格式
serialize_current_mindmap_to_markdown ：将当前加载的思维导图序列化为 Markdown 格式
serialize_current_mindmap_to_json ：将当前加载的思维导图序列化为具有 ID 映射的详细 JSON 对象

平台支持

Windows ：全面支持主题、注释、图标、图像、标签、链接、关系和 RTF 格式
macOS ：支持主题、注释和关系（与 Windows 相比支持有限）

与 Claude 和其他法学硕士的整合

该 MCP 服务器可以安装在 Claude Desktop 或其他与 MCP 兼容的应用程序中，从而允许 LLM 执行以下操作：

访问思维导图内容
操作思维导图（即将推出）
根据 LLM 生成的内容创建新的思维导图（即将推出）

故障排除

启动服务器之前确保 MindManager 正在运行
对于 macOS，请确保允许 Claude Desktop 自动化 MindManager

致谢

该项目基于mindm库构建，为 Windows 和 macOS 平台上的 MindManager 提供 Python 接口。它使用了 Anthropic 开发的模型上下文协议 (MCP) SDK。

执照

MIT 许可证 - 详情请参阅许可证文件

MindManager MCP Server

Integrations