AI导哈

思维导图生成服务

一款完全本地部署的思维导图生成服务，支持从Markdown文本创建美观的思维导图图像，无需外部设计工具，确保数据隐私和安全。

  • by sawyer-shi
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 sawyer-shi/mind-map-mcp

使用说明

思维导图MCP服务器

🔒 完全本地部署-无需外部服务或API密钥-完整的数据隐私和安全

一个模型上下文协议（MCP）服务器，允许您从Markdown文本生成漂亮的思维导图图像，而无需任何外部设计工具。完全在本地部署，无需外部服务，无API密钥，无数据离开您的机器-确保完全的数据隐私和安全。使用AI代理将您的想法、笔记和结构化内容转换为可视化思维导图。

特性

  • 思维导图生成 (🎨): 使用三种不同的布局模式，从Markdown文本创建美观、专业的思维导图。
  • 三种布局模式 (📊):
    • 中心布局：径向布局，非常适合核心概念和头脑风暴。
    • 水平布局：从左到右布局，非常适合时间线、流程和层次结构。
    • 自由/智能布局：根据内容复杂性自动选择最佳布局。
  • Markdown支持 (📝): 转换Markdown标题(#)和列表(-, 1.)转化为结构化的思维导图层次结构。
  • 汉字支持 (🈳): 内置字体检测和汉字自动处理功能。
  • 图像输出 (🖼️): 生成以Base64编码的高质量PNG图像，便于集成。
  • 三重运输支持 (🔌): stdio（用于本地）、SSE（已弃用）和流式HTTP（建议用于远程连接）。
  • 远程和本地 (🌐): 既可在本地与Cursor/Claude Desktop配合使用，也可作为远程服务使用。
  • HTTP API (🌍): 用于生成思维导图的直接HTTP端点，无需MCP协议。
  • 对设计工具的零依赖 (✨): 无需外部设计软件或手动绘图。
  • AI代理集成 (🤖): 通过MCP协议与AI代理无缝集成。
  • 完整数据隐私 (🔒): 完全本地部署，无需外部服务，无需API密钥，所有数据都保留在您的计算机上，以实现最大的安全性。

安装

快速安装（推荐）

运行安装脚本以自动配置所有内容：

# Clone the repository first
git clone https://github.com/sawyer-shi/mind-map-mcp.git
cd mind-map-mcp

# Run the installation script
python install.py

脚本将：

  • 安装所有必需的依赖项
  • 生成正确的MCP配置
  • 将配置保存到Cursor的MCP设置

手动安装

  1. 安装依赖项：
pip install -r requirements.txt
  1. 手动配置MCP服务器（请参阅 MCP_CONFIG.md 详情）

用法

服务器支持三种传输方式：

1.标准运输（供当地使用）

python server.py stdio

配置示例:

{
  "mcpServers": {
    "mind-map": {
      "command": "python",
      "args": [
        "/absolute/path/to/mind-map-mcp/server.py",
        "stdio"
      ]
    }
  }
}

⚠️ 重要:

  • 推荐：使用a 局部绝对路径 到 server.py 以获得最佳性能和可靠性。
  • 替代：您可以使用 server_standalone.py 使用GitHub URL+ uv run （见下文）。

使用带有uv run的GitHub URL（替代方案）

如果你想使用GitHub URL进行一键安装，请使用 server_standalone.py:

{
  "mcpServers": {
    "mind-map": {
      "command": "uv",
      "args": [
        "run",
        "https://raw.githubusercontent.com/sawyer-shi/mind-map-mcp/master/server_standalone.py",
        "stdio"
      ]
    }
  }
}

备注：独立版本将自动下载 src 第一次运行GitHub上的模块，这可能比使用本地安装慢。看 GITHUB_URL_USAGE.md 详细说明。

2.SSE传输（服务器发送事件-已弃用）

python server.py sse

SSE传输连接:

{
  "mcpServers": {
    "mind-map": {
      "url": "http://localhost:8899/sse"
    }
  }
}

3.流式HTTP传输（建议用于远程连接）

python server.py streamable-http

可流式HTTP传输连接:

{
  "mcpServers": {
    "mind-map": {
      "url": "http://localhost:8899/mcp"
    }
  }
}

环境变量

SSE和流式HTTP传输

当使用SSE或Streamable HTTP协议运行服务器时，您可以设置 FASTMCP_PORT 用于控制服务器监听端口的环境变量（如果未设置，默认值为8899）。

示例（Windows PowerShell）:

$env:FASTMCP_PORT="8007"
python server.py streamable-http

示例（Linux/macOS）:

FASTMCP_PORT=8007 python server.py streamable-http

标准运输

使用stdio协议时，不需要环境变量。服务器直接通过标准输入/输出进行通信。

工具

  • create_center_mindmap：生成径向思维导图。
  • create_horizontal_mindmap：生成水平思维导图。
  • create_free_mindmap：智能布局选择。

所有工具都接受 markdown_content 字符串作为输入。

HTTP生成API

您还可以直接通过HTTP POST生成图像：

端点: POST /generate

身体:

{
  "markdown_content": "# Root\n- Child 1\n- Child 2",
  "layout": "free"  // Options: center, horizontal, free
}

相关 MCP