Mindmap MCP Server

Mindmap MCP Server

site icon
2025.03.23 0
Python思维导图生成Markdown转换开发效率内容生成
Mindmap MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,主要用于将 Markdown 内容转换为交互式思维导图。它支持多种安装方式,包括 pip、uvx 和 Docker,并可以与 Claude Desktop 或其他 MCP 客户端配合使用。该服务提供了两种返回类型选项:HTML 内容或文件路径,以满足不同场景的需求。
View on GitHub

Overview

基本能力

产品定位

Mindmap MCP Server 是一个用于将 Markdown 内容转换为交互式思维导图的工具,旨在提高开发者和内容创作者的效率。

核心功能

  • 将 Markdown 转换为交互式思维导图 HTML
  • 支持创建离线可用的思维导图
  • 可选择隐藏工具栏
  • 支持返回 HTML 内容或文件路径

适用场景

  • 项目规划和文档整理
  • 会议记录和头脑风暴
  • 教育和学习笔记
  • 任何需要将结构化内容可视化的场景

工具列表

  1. markdown-to-mindmap-content
  2. 将 Markdown 转换为 HTML 思维导图并返回整个 HTML 内容
  3. 适用于简单的思维导图,可直接在 AI 客户端的 artifact 中预览

  4. markdown-to-mindmap-file

  5. 将 Markdown 转换为 HTML 思维导图并保存到文件
  6. 适用于复杂的思维导图或需要节省 token 的场景

常见问题解答

  • 文件未找到:检查是否正确挂载了 Docker 容器卷,路径格式是否正确,以及 Docker 是否有权限访问目录
  • Docker 命令未找到:验证 Docker 是否已安装并在 PATH 中,或尝试使用 Docker 的绝对路径
  • 服务器未出现在 Claude 中:在配置更改后重启 Claude for Desktop,检查 Claude 日志中的连接错误,确认 Docker 是否正在运行

使用教程

使用依赖

  • 使用 pythonuvx 运行服务器时需要安装 Node.js

安装教程

使用 pip 安装

pip install mindmap-mcp-server

使用 uvx 安装

uvx mindmap-mcp-server

使用 Docker 安装

docker pull ychen94/mindmap-converter-mcp

调试方式

使用 uvx

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

使用 python

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

使用 Docker

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

许可证

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