MindManager MCP Server

MindManager MCP Server

site icon
2025.04.02 1
Python思维导图工具LLM 集成开发效率
MindManager MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,专为 `mindm` 库设计,提供了与 MindManager(Windows 和 macOS 平台上的思维导图软件)交互的标准化接口。该服务允许通过编程方式操作 MindManager 文档、主题、关系等思维导图元素,并支持将思维导图导出为多种格式(如 Mermaid、Markdown、JSON),以便在 LLM(大语言模型)聊天中使用。
View on GitHub

Overview

基本能力

产品定位

MindManager MCP Server 是一个连接 MindManager 思维导图软件与 MCP 协议的桥梁,旨在通过标准化接口增强开发者和 LLM 对 MindManager 的操作能力。

核心功能

  • 思维导图结构获取:检索思维导图结构和中心主题。
  • 导出功能:将思维导图导出为 Mermaid、Markdown、JSON 格式。
  • MindManager 信息获取:获取 MindManager 安装信息和库文件夹路径。
  • 当前选择获取:获取 MindManager 中当前选中的主题。

适用场景

  • 开发效率工具:通过编程方式操作思维导图,提升开发效率。
  • LLM 集成:将思维导图内容集成到 LLM 聊天中,增强上下文理解。
  • 跨平台协作:在 Windows 和 macOS 上统一操作 MindManager。

工具列表

  • 文档交互工具
  • get_mindmap:获取当前思维导图结构。
  • get_selection:获取当前选中的主题。
  • get_library_folder:获取 MindManager 库文件夹路径。
  • get_grounding_information:提取思维导图中的基础信息(中心主题、选中子主题)。
  • 序列化工具
  • serialize_current_mindmap_to_mermaid:将当前思维导图序列化为 Mermaid 格式。
  • serialize_current_mindmap_to_markdown:将当前思维导图序列化为 Markdown 格式。
  • serialize_current_mindmap_to_json:将当前思维导图序列化为 JSON 对象(带 ID 映射)。

常见问题解答

  • MindManager 未运行:确保启动服务前 MindManager 已运行。
  • macOS 权限问题:确保允许 Claude Desktop 自动化 MindManager。

使用教程

使用依赖

  • Python 3.12 或更高版本。
  • mcp 包(Model Context Protocol SDK)。
  • mindm 库(包含在项目中)。
  • MindManager(支持版本:23-)安装在 Windows 或 macOS 上。

安装教程(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

# 安装 nodejs
choco install nodejs # 如果已安装 chocolatey。否则通过其他方式安装 nodejs
refreshenv
node -v
npm install -g npx

调试方式

# 运行 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.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 并终止所有后台进程。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。