CodeMind MCP

一个 MCP（Model Context Protocol）服务器，通过自动化流程帮助用户快速理解代码仓库并生成思维导图。

背景

是不是老是忘记git命令？

本MCP 可以用于管理仓库、拉取请求、问题等。

得到一个项目是不是看不懂项目？

本MCP会作为一个专业的架构师，帮助你快速理解代码仓库并生成思维导图。

核心功能

gitcode_request: 通用的 GitCode API 调用工具，用于管理仓库、拉取请求、问题等。
mindmap: 读取当前目录及其子目录中的所有 README.md 文件，生成思维导图：
- 递归查找并收集所有 README.md 文件
- 合并文件内容并调用 Coze 工作流生成思维导图
- 返回思维导图公开访问链接

安装与使用

环境要求: Node.js >= 18.x

全局安装

npm install -g @lucianaib/codemind-mcp
codemind-mcp

在 MCP 客户端中配置

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

![CodeBuddy 配置成功示例.png](src\CodeBuddy 配置成功示例.png)

工具调用参数

`gitcode_request`

baseUrl: string (可选)，如 https://api.gitcode.com
token: string，鉴权令牌（支持 Bearer <token> 或纯 token）
method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE"
path: string，如 /v1/repos
query: Record<string, unknown> (可选)
body: Record<string, unknown> (可选)
headers: Record<string, string> (可选)

拉取项目示例.png

`mindmap`

prompt: string (可选)，用于自定义生成思维导图的提示词

思维导图示例.png

开发与代码结构

src/index.ts: MCP 服务器入口，使用 McpServer 注册工具
src/gitcode.ts: GitCode API 的通用请求封装
src/mindmap.ts: README.md 文件收集及调用 Coze API 的核心逻辑

安全提示

重要: Coze API 凭证目前硬编码在 src/mindmap.ts 中，存在安全风险。生产环境请移至环境变量。

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。