repo-context-mcp 今日发布

repo-context-mcp 是一款面向 AI 编程智能体的 MCP 服务器，解决大模型在理解大型代码仓库时的上下文膨胀问题。通过三个工具让 Claude Code、Codex、Cursor 只看到当前任务真正需要的代码上下文。

核心功能

repo_map：仓库结构轻量地图

快速生成仓库目录树，自动识别并优先展示各语言的入口文件和配置文件（如 package.json、Cargo.toml、requirements.txt、go.mod 等）。模型无需遍历 node_modules 或 vendor 目录，即可掌握仓库结构与入口。

search_code：精准代码搜索

基于子字符串的快速搜索，支持按路径和行号精确定位。在已知函数名或变量名时比语义搜索更快速、更可预测，适合智能体执行修复或重构任务时快速定位目标代码。

pack_context：Token 预算感知的上下文打包

根据指定的主题焦点（如 auth,api）和 Token 上限（如 8000），从仓库中智能选取最相关的文件片段，打包成结构化 Markdown 供大模型使用。自动跳过 node_modules、dist、build 等无意义目录。

安装配置

前置要求：Node.js 18 或更高版本。

# 通过 npx 直接运行
npx -y repo-context-mcp map .

# 从源码构建
git clone https://github.com/nduc99911/repo-context-mcp.git
cd repo-context-mcp && npm install && npm run build
node dist/cli.js map .

MCP 客户端配置

Claude Desktop / Claude Code，在 MCP 配置文件中添加：

{
  "mcpServers": {
    "repo-context": {
      "command": "npx",
      "args": ["-y", "repo-context-mcp"],
      "env": { "REPO_CONTEXT_ROOT": "/absolute/path/to/your/repo" }
    }
  }
}

Cursor：Settings → MCP → 添加服务器，command 填 npx，args 填 ["-y", "repo-context-mcp"]。

Codex 或其他 stdio 客户端：

REPO_CONTEXT_ROOT=/path/to/repo node /path/to/repo-context-mcp/dist/server.js

使用示例

# 生成仓库地图
node dist/cli.js map .

# 搜索代码
node dist/cli.js search login .

# 按 Token 预算打包上下文
node dist/cli.js pack . --focus auth,api --max-tokens 8000

# 输出 JSON 格式
node dist/cli.js map . --json

效果预览

• Token 消耗降低：智能过滤 node_modules 和构建产物
• 定位速度提升：通过 repo_map 快速掌握仓库结构
• 上下文相关性提高：pack_context 按任务焦点打包

适用场景

• 大型代码仓库理解（数千个文件的 monorepo）
• 精确修复任务（搜索特定函数或变量）
• 跨文件重构（需要理解模块间依赖关系）
• 持续集成（CI 流程中自动生成代码分析报告）

注意事项

• 完全本地运行，不上传任何代码到云端，无遥测数据
• stdio 传输方式，兼容所有支持 MCP 协议的客户端
• 环境变量 REPO_CONTEXT_ROOT 可设置默认仓库根目录