思维导图 MCP 服务器

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

这是一个模型上下文协议 (MCP) 服务器，可以从 Markdown 文本生成美观的思维导图图像，而无需任何外部设计工具。完全本地部署，不需要外部服务、API 密钥，并且数据不会离开您的机器，确保了完整的数据隐私和安全性。通过您的 AI 代理将您的想法、笔记和结构化内容转换为可视化的思维导图。

功能

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

安装

快速安装（推荐）

运行安装脚本来自动配置一切：

bash

# 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. 安装依赖项：

bash

pip install -r requirements.txt

1. 手动配置 MCP 服务器（详情请参阅 MCP_CONFIG.md）

使用

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

1. Stdio 传输（用于本地使用）

bash

python server.py stdio

配置示例：

bash

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

⚠️ 重要:

• 推荐: 使用 本地绝对路径 到 server.py 以获得最佳性能和可靠性。
• 替代方案: 您可以使用 GitHub URL + uv run 来使用 server_standalone.py（见下文）。

使用 GitHub URL 与 uv run（替代方案）

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

bash

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

注意: 独立版本将在首次运行时自动从 GitHub 下载 src 模块，这可能比使用本地安装更慢。有关详细说明，请参阅 GITHUB_URL_USAGE.md。

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

bash

python server.py sse

SSE 传输连接：

bash

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

3. 可流式 HTTP 传输（推荐用于远程连接）

bash

python server.py streamable-http

可流式 HTTP 传输连接：

bash

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

环境变量

SSE 和可流式 HTTP 传输

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

示例（Windows PowerShell）：

powershell

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

示例（Linux/macOS）：

bash

FASTMCP_PORT=8007 python server.py streamable-http

Stdio 传输当使用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
}