robertZaufall
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mindm (MindManager)": {
"args": [
"run",
"--with",
"mindm\u003e=0.0.4.6",
"--with",
"mindm-mcp\u003e=0.0.1.50",
"--with",
"fastmcp",
"--with",
"markdown-it-py",
"-m",
"mindm_mcp.server"
],
"command": "uv",
"env": {
"VIRTUAL_ENV": "/Users/master/git/mindm-mcp/.venv"
}
}
}
}可用工具 （9 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get_mindmap 2 个参数
n Retrieves the current mind map structure from MindManager.nn Args:n mode (str): Detail level ( full , content , text ). Defaults to full .n turbo_mode (bool): Enable turbo mode (text only). Defaults to false.nn Returns:n Dict[str, Any]: Serialized mind map structure or error dictionary.n
该工具无需必填参数，直接调用即可
get_selection 2 个参数
n Retrieves the currently selected topics in MindManager.nn Args:n mode (str): Detail level ( full , content , text ). Defaults to full .n turbo_mode (bool): Enable turbo mode (text only). Defaults to false.nn Returns:n Union[List[Dict[str, Any]], Dict[str, str]]: List of serialized selected topics or error dictionary.n
该工具无需必填参数，直接调用即可
get_library_folder
n Gets the path to the MindManager library folder.nn Returns:n Union[str, Dict[str, str]]: The library folder path or error dictionary.n
该工具无需必填参数，直接调用即可
get_mindmanager_version
n Gets the version of the MindManager application.nn Returns:n Union[str, Dict[str, str]]: The version of the MindManager application or error dictionary.n
该工具无需必填参数，直接调用即可
get_grounding_information 2 个参数
n Extracts grounding information (central topic, selected subtopics) from the mindmap.nn Args:n mode (str): Detail level ( full , content , text ). Defaults to full .n turbo_mode (bool): Enable turbo mode (text only). Defaults to false.nn Returns:n Union[List[str], Dict[str, str]]: A list containing [top_most_topic, subtopics_string] or error dictionary.n
该工具无需必填参数，直接调用即可
serialize_current_mindmap_to_mermaid 3 个参数
n Serializes the currently loaded mindmap to Mermaid format.nn Args:n id_only (bool): If true, only include IDs without detailed attributes. Defaults to false.n mode (str): Detail level ( full , content , text ). Defaults to full .n turbo_mode (bool): Enable turbo mode (text only). Defaults to false.nn Returns:n Union[str, Dict[str, str]]: Mermaid formatted string or error dictionary.n
该工具无需必填参数，直接调用即可
serialize_current_mindmap_to_markdown 3 个参数
n Serializes the currently loaded mindmap to Markdown format.nn Args:n include_notes (bool): If true, include notes in the serialization. Defaults to true.n mode (str): Detail level ( full , content , text ). Defaults to full .n turbo_mode (bool): Enable turbo mode (text only). Defaults to false.nn Returns:n Union[str, Dict[str, str]]: Markdown formatted string or error dictionary.n
该工具无需必填参数，直接调用即可
serialize_current_mindmap_to_json 3 个参数
n Serializes the currently loaded mindmap to a detailed JSON object with ID mapping.nn Args:n ignore_rtf (bool): Whether to ignore RTF content. Defaults to true.n mode (str): Detail level ( full , content , text ). Defaults to full .n turbo_mode (bool): Enable turbo mode (text only). Defaults to false.nn Returns:n Union[Dict[str, Any], Dict[str, str]]: JSON serializable dictionary or error dictionary.n
该工具无需必填参数，直接调用即可
get_versions
n Get the versions of the MindManager Automation MCP Server components.nn Returns:n Dict[str, str]: A dictionary containing the versions of the components.n
该工具无需必填参数，直接调用即可
服务介绍
MindManager MCP 服务器
为 mindm 库实现的模型上下文协议 (MCP) 服务器，提供了一个标准化接口来与 Windows 和 macOS 上的 MindManager 进行交互。
&style=for-the-badge&color=blue)
&style=for-the-badge&color=lightblue)
概述
此服务器允许您通过模型上下文协议 (MCP) 以编程方式与 MindManager 交互，这是一种向大语言模型 (LLMs) 提供上下文和工具的标准方法。它利用 mindm 库来操作 MindManager 文档、主题、关系和其他思维导图元素。
示例：
功能
- 获取思维导图结构和中心主题
- 将思维导图导出为 Mermaid、Markdown、JSON 格式，以便在 LLM 聊天中使用
- 获取有关 MindManager 安装和库文件夹的信息
- 从 MindManager 获取当前选中的内容
计划中的功能
- 从序列化数据创建新的思维导图
- 添加、修改和操作主题和子主题
- 在主题之间添加关系
- 向主题添加标签
- 设置文档背景图片
要求
- Python 3.12 或更高版本
mcp包（模型上下文协议 SDK）mindm库（包含在此项目中）- 安装在 Windows 或 macOS 上的 MindManager（支持版本：23-）
macOS 安装
bash
克隆仓库（如果您是从仓库中使用它的话）
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 安装
bash
切换到 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 检查器
bash
运行带有检查器的 mcp
uv run --with mind --with fastmcp --with markdown-it-py mcp dev mindm_mcp/server.py
Claude Desktop
本地 Python 文件
根据需要调整本地文件路径。
json
{
"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。
json
{
"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: 将当前加载的思维导图序列化为 Mermaid 格式serialize_current_mindmap_to_markdown: 将当前加载的思维导图序列化为 Markdown 格式serialize_current_mindmap_to_json: 将当前加载的思维导图序列化为带有 ID 映射的详细 JSON 对象
平台支持
- Windows: 完全支持主题、笔记、图标、图像、标签、链接、关系和 RTF 格式
- macOS: 支持主题、笔记和关系（与 Windows 相比支持有限）
与 Claude 及其他 LLM 的集成
此 MCP 服务器可以安装在 Claude Desktop 或其他兼容 MCP 的应用程序中，允许 LLM 执行以下操作：
- 访问思维导图内容
- 操作思维导图（即将推出）
- 基于 LLM 生成的内容创建新的思维导图（即将推出）
故障排除
- 确保在启动服务器之前 MindManager 已经运行
- 对于 macOS，确保您允许 Claude Desktop 自动化 MindManager
致谢
本项目基于 mindm 库构建，提供了在 Windows 和 macOS 平台上与 MindManager 交互的 Python 接口。它使用了由 Anthropic 开发的 Model Context Protocol (MCP) SDK。
许可证
MIT 许可证 - 详情请参阅 LICENSE 文件
