@lucianaib/mind-map-mcp

@lucianaib/mind-map-mcp

一个用于生成思维导图的 MCP (Model Context Protocol) 服务器。

功能特性

• 🧠 根据文本内容自动生成思维导图
• 🔗 返回可访问的思维导图图片链接
• 🚀 支持 CodeBuddy、Cursor 等 MCP 客户端
• 🌐 基于 Coze API 的强大思维导图生成能力

安装

通过 NPM 安装

npm install -g @lucianaib/mind-map-mcp

通过 npx 直接使用

npx @lucianaib/mind-map-mcp

配置

在 CodeBuddy 中配置

• 打开 CodeBuddy 设置
• 找到 MCP 服务器配置
• 添加新的服务器：

{
  "mcpServers": {
    "mind-map": {
      "command": "npx",
      "args": ["@lucianaib/mind-map-mcp"]
    }
  }
}

在 Cursor 中配置

• 打开 Cursor 设置 (Ctrl/Cmd + ,)
• 搜索 "MCP"
• 在 MCP 服务器配置中添加：

{
  "mind-map": {
    "command": "npx",
    "args": ["@lucianaib/mind-map-mcp"]
  }
}

使用方法

配置完成后，你可以在支持 MCP 的工具中使用以下功能：

生成思维导图

请帮我生成一个关于"分布式系统架构"的思维导图

或者直接调用工具：

使用 generate_mindmap 工具，内容为："机器学习的基本概念和应用"

可用工具

generate_mindmap

根据输入内容生成思维导图。

参数：

• content (string, 必需): 要转换为思维导图的内容描述

返回：

• 思维导图的图片链接
• 生成状态信息

示例：

{
  "content": "深度学习的发展历程和主要技术"
}

开发

本地开发

• 克隆仓库：

git clone https://github.com/lfrbmw/Mind-map-mcp.git
cd Mind-map-mcp

• 安装依赖：

npm install

• 构建项目：

npm run build

• 启动开发模式：

npm run dev

项目结构

Mind-map-mcp/
├── src/
│   └── index.ts          # 主要的 MCP 服务器代码
├── dist/                 # 编译后的 JavaScript 文件
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript 配置
└── README.md            # 项目说明

API 说明

本工具使用 Coze API 来生成思维导图。API 详情：

• 端点: https://api.coze.cn/v1/workflow/run
• 方法: POST
• 认证: Bearer Token
• 返回: 思维导图图片链接

故障排除

常见问题

• "未知工具" 错误

  • 确保 MCP 服务器正确配置
  • 检查工具名称是否正确 (generate_mindmap)

• API 请求失败

  • 检查网络连接
  • 确认 API 服务状态

• 中文编码问题

  • 本工具已处理中文编码，支持中文内容输入

调试模式

启动时会在 stderr 输出调试信息，可以通过查看日志来诊断问题。

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

v1.0.0

• 初始版本发布
• 支持基本的思维导图生成功能
• 支持 CodeBuddy 和 Cursor 集成