mcp-codemap 🗺️

让 AI 真正"看懂"你的项目 — 自动分析代码库、生成 README、架构图、依赖图谱、API 文档

🔥 测试结果

在 Express.js 框架（201个文件、53个目录）上的实际测试：

| 工具 | 测试结果 | |------|---------| | project_scan | ✅ 正确检测 Node.js 项目，201 文件，53 目录，702KB | | project_tree | ✅ 生成完整目录树，支持深度控制 | | project_deps | ✅ 找到 44 个依赖，正确区分 prod/dev | | project_apis | ✅ 发现 13 个 API 端点 | | project_readme | ✅ 自动生成包含概览/安装/依赖/API 的 README（见下文示例） | | project_arch | ✅ 生成 Mermaid 架构图 | | project_summary | ✅ 生成适合 LLM 上下文的精简摘要 | | project_files | ✅ 按扩展名/名称模式搜索文件 |

生成 README 示例（对 Express.js 运行 project_readme 的输出）

# test-express
> Auto-generated by mcp-codemap

## 📋 Overview
- **Type:** Node.js  |  **Stack:** Node.js
- **Files:** 201  |  **Size:** 702.9 KB

## 🚀 Quick Start
npm install
npm run dev

## 📦 Dependencies (44)
- accepts: ^2.0.0
- body-parser: ^2.2.1
- ...42 more

## 🌐 API Endpoints (13)
| Method | Path | File |
| GET | env | test/app.js |
| GET | etag fn | test/config.js |
| ...11 more |

📦 安装

npm install -g mcp-codemap

然后配置到 Claude Code 的 claude.json：

{
  "mcpServers": {
    "mcp-codemap": {
      "command": "npx",
      "args": ["mcp-codemap"]
    }
  }
}

🛠️ 8 个工具

| 工具 | 说明 | |------|------| | project_scan | 扫描项目：技术栈、入口、文件分布 | | project_tree | 目录树可视化 | | project_deps | 依赖分析（支持 npm/pip/cargo） | | project_apis | API 端点自动发现 | | project_files | 按扩展名/模式搜索文件 | | project_readme | 一键生成 README 文档 | | project_arch | Mermaid 架构图 | | project_summary | LLM 上下文摘要 |

📄 License MIT

💝 爱发电 · ￥3.9