代码思维MCP
WEIAIb/CodeMind-MCP
Hosted
5 Stars
4.9k 次浏览
LucianaIB
更新于 2026-08-23
一个模型上下文协议（MCP）服务器，通过自动化流程帮助用户快速理解代码仓库并生成思维导图。它包括管理仓库、拉取请求、问题以及从README.md文件生成思维导图的功能。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"CodeMind": {
"args": [
"@lucianaib/codemind-mcp"
],
"command": "npx"
}
}
}可用工具 （3 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
gitcode_request 7 个参数 需填 3 项
调用GitCode API的通用工具
必填参数：token、method、path
mindmap 1 个参数
对当前项目的README.md文件制作思维导图
该工具无需必填参数，直接调用即可
git_project_info 2 个参数 需填 1 项
获取Git项目信息，支持不同Git平台
必填参数：repoUrl
服务介绍
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"]
}
}
}
工具调用参数
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> (可选)
mindmap
- prompt: string (可选)，用于自定义生成思维导图的提示词
开发与代码结构
src/index.ts: MCP 服务器入口，使用McpServer注册工具src/gitcode.ts: GitCode API 的通用请求封装src/mindmap.ts: README.md 文件收集及调用 Coze API 的核心逻辑
安全提示
重要: Coze API 凭证目前硬编码在 src/mindmap.ts 中，存在安全风险。生产环境请移至环境变量。
许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。
