MindManager MCP Server

警告

**已弃用：**此 MCP 将不再继续开发。请改用 https://github.com/robertZaufall/mindm-skill 中的 Codex/Claude 技能。

MindManager MCP 服务

一个基于 mindm 库实现的 Model Context Protocol（MCP）服务，为在 Windows 和 macOS 上与 MindManager 交互提供标准化接口。

概述

此服务允许你通过 Model Context Protocol（MCP）以编程方式与 MindManager 交互。MCP 是一种向大模型提供上下文和工具的标准化方式。它利用 mindm 库来操作 MindManager 文档、主题、关系和其他思维导图元素。

动图示例（在 Windows 上使用 VSCode 中的 Codex）

• 示例 完善单个主题，包括为新主题添加标签和图标：

获取当前 Mindmanager 思维导图的 Mermaid 表示（完整格式），将给定主题至少细化两层（不只是主题），为最重要的 3 个主题添加“Important”标签，并为除中心主题外的每个主题添加相应的内置图标，然后创建新的 MindManager 思维导图

• 示例 完善单个主题，包括为新主题生成备注文本：

• 示例 克隆思维导图，包括所有受支持的主题属性：

其他示例

客户端

获取当前 MindManager 思维导图，将每个主题翻译成德语，并创建一张新的 MindManager 思维导图（简单模式）。

获取当前 MindManager 思维导图，将每个主题细化两层，并创建一张新的 MindManager 思维导图（简单模式）。

Shell：

codex exec "get the current MindManager mindmap, add a meaningful emoji to every topic and create new MindManager mindmap (simple)"

备注：表情符号仅在 macOS 上有效。

功能

• 获取思维导图结构和中心主题
• 将思维导图导出为 Mermaid、Markdown、JSON 格式，以便在大模型对话中使用
• 直接从 Mermaid（完整或简化语法）创建 MindManager 思维导图
• 获取 MindManager 和软件包版本，以便快速诊断
• 获取 MindManager 安装位置和库文件夹的信息
• 获取 MindManager 中当前选中的内容

计划中的功能

• 无需通过 Mermaid 往返即可添加、修改和操作主题及子主题
• 添加主题之间的关系
• 为主题添加标签
• 设置文档背景图片

要求

• Python 3.12 或更高版本
• mcp 软件包（Model Context Protocol 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 inspector

# run mcp with inspector
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.5.3",
        "--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.5.3",
          "--with",
          "mindm-mcp>=0.0.2.1",
          "--with",
          "fastmcp",
          "--with",
          "markdown-it-py",
          "-m",
          "mindm_mcp.server"
        ],
        "env": {
            "VIRTUAL_ENV": "/Users/master/git/mindm-mcp/.venv"
        }
      }
  }
}

提示：如果 Windows 上的 MCP 服务没有显示锤子图标，请关闭 Claude Desktop 并结束所有后台进程。

Codex（VSCode 扩展 / CLI）

本地 Python 文件

config.toml（根据需要调整本地文件的路径）。

[features]
rmcp_client = true

[mcp_servers.mindmanager]
command = "uv"
args = ["run", "--with", "mindm>=0.0.5.3", "--with", "fastmcp", "--with", "markdown-it-py", "/Users/master/git/mindm-mcp/mindm_mcp/server.py"]

软件包仓库中的模块

config.toml

[features]
rmcp_client = true

[mcp_servers.mindmanager]
command = "uv"
args = ["run", "--with", "mindm>=0.0.5.3", "--with", "fastmcp", "--with", "markdown-it-py", "--with", "mindm-mcp>=0.0.2.1", "-m", "mindm_mcp.server"]

VSCode Chat（GitHub Copilot）

本地 Python 文件：

根据需要调整本地文件的路径。

uv run --with mindm>=0.0.5.3 --with fastmcp --with markdown-it-py /Users/master/git/mindm-mcp/mindm_mcp/server.py

或在 mcp.json 中定义服务：

		"Mindmanager": {
			"type": "stdio",
			"command": "uv",
			"args": [
				"run",
				"--with",
				"mindm>=0.0.5.3",
				"--with",
				"fastmcp",
				"--with",
				"markdown-it-py",
				"/Users/master/git/mindm-mcp/mindm_mcp/server.py"
			]
		}

软件包仓库中的模块

uv run --with mindm>=0.0.5.3 --with fastmcp --with markdown-it-py --with mindm-mcp>=0.0.2.1 -m mindm_mcp.server

或在 mcp.json 中定义服务：

		"Mindmanager": {
			"type": "stdio",
			"command": "uv",
			"args": [
				"run",
				"--with",
				"mindm>=0.0.5.3",
				"--with",
				"fastmcp",
				"--with",
				"markdown-it-py",
				"--with",
				"mindm-mcp>=0.0.2.1",
				"-m",
				"mindm_mcp.server"
			]
		}

MCP 工具

此服务通过 Model Context Protocol 提供以下工具：

文档交互

• get_mindmap：从 MindManager 获取当前思维导图结构
• get_selection：获取 MindManager 中当前选中的主题
• get_library_folder：获取 MindManager 库文件夹的路径
• get_mindmanager_version：获取已安装的 MindManager 版本
• get_grounding_information：从思维导图中提取定位信息（中心主题、选中的子主题）

序列化

• serialize_current_mindmap_to_mermaid：将当前加载的思维导图序列化为 Mermaid 格式
• serialize_current_mindmap_to_markdown：将当前加载的思维导图序列化为 Markdown 格式
• serialize_current_mindmap_to_json：将当前加载的思维导图序列化为带 ID 映射的详细 JSON 对象

创建

• create_mindmap_from_mermaid：根据 Mermaid 创建 MindManager 导图（支持包含 ID 和元数据的完整语法）
• create_mindmap_from_mermaid_simple：根据简化的 Mermaid 文本创建 MindManager 导图

版本信息

• get_versions：返回 mindm-mcp 和 mindm 软件包版本，供调试使用

平台支持

• Windows：全面支持主题、备注、图标、图像、标签、链接、关系和 RTF 格式
• macOS：支持主题、备注和关系（支持程度有限，低于 Windows）

与 Claude 和其他大模型集成

此 MCP 服务可安装在 Claude Desktop 或其他兼容 MCP 的应用程序中，让大模型能够：

1. 访问思维导图内容
2. 操作思维导图（即将推出）
3. 根据大模型生成的内容创建新思维导图（即将推出）

故障排除

• 启动服务前，请确保 MindManager 正在运行
• 在 macOS 上，请确保允许 Claude Desktop 自动操作 MindManager

MCPHub

已通过 MCPHub 认证

致谢

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

许可证

MIT 许可证 — 详情请参阅 LICENSE 文件