MindManager MCP Server

这是针对mindm库的模型上下文协议（MCP）服务器实现，提供了一个标准化接口，用于在Windows和macOS上与MindManager进行交互。

概述

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

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

• 示例 细化单个主题，包括新主题的标签和图标：

获取当前的MindManager思维导图作为Mermaid（完整），至少细化给定的主题两层（不仅仅是主题），将“重要”标签添加到最重要的三个主题，并为每个主题（除了中心主题）添加相应的库存图标，创建新的MindManager思维导图

• 示例 细化单个主题，包括为新主题生成笔记文本：

• 示例 克隆地图，包括所有支持的主题属性：

其他示例

客户端

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

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

命令行：

codex exec "获取当前的MindManager思维导图，为每个主题添加有意义的表情符号并创建新的MindManager思维导图（简单）"

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

特性

• 获取思维导图结构和中心主题
• 导出思维导图到Mermaid、Markdown、JSON格式，以便在LLM聊天中使用
• 直接从Mermaid创建MindManager思维导图（完整或简化语法）
• 获取MindManager及其包版本以快速诊断
• 获取关于MindManager安装和库文件夹的信息
• 获取MindManager中的当前选择

计划特性

• 添加、修改和操作主题及子主题，无需Mermaid往返
• 在主题之间添加关系
• 向主题添加标签
• 设置文档背景图像

要求

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

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

# 安装Node.js
choco install nodejs # 如果已安装Chocolatey。如果没有，请以其他方式安装Node.js
refreshenv
node -v
npm install -g npx

使用

MCP检查器

# 使用检查器运行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.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"
        }
      }
  }
}

提示：如果MCP服务器在Windows上没有显示锤子图标，请关闭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工具

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

文档交互

• 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：将当前加载的思维导图序列化为详细的JSON对象，带有ID映射

创建

• create_mindmap_from_mermaid：从Mermaid构建MindManager地图（完整的语法，带有ID和元数据）
• create_mindmap_from_mermaid_simple：从简化的Mermaid文本构建MindManager地图

版本

• get_versions：返回mindm-mcp和mindm包版本，用于调试

平台支持

• Windows：完全支持主题、笔记、图标、图像、标签、链接、关系和RTF格式
• macOS：支持主题、笔记和关系（与Windows相比有限的支持）

与Claude和其他LLMs的集成

此MCP服务器可以安装在Claude Desktop或其他兼容MCP的应用程序中，使LLMs能够：

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

故障排除

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

MCPHub

已在MCPHub认证

致谢

该项目基于mindm库构建，提供了在Windows和macOS平台上与MindManager交互的Python接口。它使用由Anthropic开发的模型上下文协议（MCP）SDK。

许可证

MIT许可证 - 查看LICENSE文件以获取详细信息