vlm代码上下文mcp
AI编码代理的持久内存。
你的代理人在两次会议之间忘记了一切。这解决了这个问题。```bash
npm install vlm-code-context-mcp
npx code-context-mcp setup .
claude mcp add code-context npx -y vlm-code-context-mcp ./context.db
三个命令。API密钥为零。一 `context.db` 文件。
______________________________________________________________________
## 基准
在10个真实的开发任务(检索、调试、重构、实现)中进行了测试,然后通过200个随机试验和Wilcoxon符号秩检验进行了验证。
||MCP |香草|已保存|
|---|---|---|---|
| **代币** | 4,806 | 8,726 | **44.9%** |
| **工具调用** | 49 | 68 | **27.9%** |
| **随机胜率** | — | — | **90.5%** (p\<0.001)|
MCP工具返回结构化摘要(导出、deps、文件角色),而不是原始文件内容。特工们读得少,知道得多。
Reproduce it yourself```bash
# Deterministic — 10 tasks, 6 categories
npm test -- test/benchmark.test.ts
# Stochastic — 200 randomized trials, Wilcoxon test, bootstrap CI
npm test -- test/benchmark-stochastic.test.ts
完整的方法论 基准指南.md.
快速开始
1·安装```bash
npm install vlm-code-context-mcp
**2·初始化**```bash
npx code-context-mcp setup .
创造 context.db,为你的代码库建立索引,组建一个7个代理团队,并编写 .mcp.json.
3·重新启动AI客户端
重新启动Claude Code(或任何MCP客户端)。证实 get_project_status.
4·启动仪表板```bash
npx code-context-dashboard ./context.db
开放时间: `http://localhost:3333` 实时SSE更新。要在文件保存时自动重新索引,请执行以下操作:```bash
npx code-context-dashboard ./context.db 3333 .
5·跑完你的第一个冲刺
键入克劳德代码:```
/kickoff
编排者引导你穿越视觉→ 发现→ 里程碑→ 史诗→ 票→ 冲刺→ 实施→ 复古——一次一个问题。智能简历让你停下来稍后再接。
______________________________________________________________________
## 仪表盘
**共7页。实时SSE更新。零投票。**
|页面|显示内容|
|---|---|
| **仪表盘** |看板、相位门步进器、烧毁、速度、冲刺检查表|
| **规划** |里程碑跟踪器、史诗般的进展、发现管道|
| **代码** |文件树、依赖关系图、导出/导入映射、更改历史|
| **团队** |代理卡、模特徽章、情绪趋势、工作量条|
| **复古** |Bento网格洞察、交叉冲刺模式、重复主题|
| **基准** |MCP与香草与动画指标的比较|
| **速度** |冲刺趋势,承诺与完成|
每个数据库突变都会通过SQLite WAL监控触发即时刷新。
______________________________________________________________________
## Slash命令
直接在Claude Code中键入这些。
|命令|它的作用|
|---|---|
| `/kickoff` |全生命周期指导——复古愿景。 **从这里开始。** |
| `/sprint` |Sprint专用循环——计划→ 实施→ QA → 复古→ 存档|
| `/ticket` |在完整的上下文中移动票证的整个生命周期|
| `/milestone` |通过史诗般的验证创建、更新、关闭里程碑|
| `/retro` |采用燃耗+速度分析的数据支持回顾|
| `/sprint-connect` |将仪表板UI连接到Claude会话|
______________________________________________________________________
## 运作原理
每个命令都遵循相同的模式: **在执行任何操作之前从数据库加载上下文。**```
search_files("auth middleware") → find the right file
get_file_context("src/auth.ts") → understand role, exports, dependents
Read("src/auth.ts") → only now read the actual code
没有代理在其上下文窗口中保存完整的项目。他们从共享的SQLite大脑中查询所需内容,并将结果写回。```
┌─────────────────────────────────────────────────────┐
│ Claude Code / MCP Client │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ /kickoff │ │ /sprint │ │ /ticket │ ... │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ └──────────────┼─────────────┘ │
│ ▼ │
│ 76 MCP Tools │
│ (32 read + 44 write) │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ context.db (SQLite) │ │
│ │ 30 tables · WAL mode · <5ms reads │ │
│ └──────────────────┬──────────────────┘ │
│ │ WAL watcher │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ React Dashboard (Vite) │ │
│ │ 62 components · SSE live updates │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘
______________________________________________________________________
## 代理团队
9个可配置的代理,每个代理都有一个角色、模型和情绪评分。
|角色|焦点|
|---|---|
|产品负责人|愿景、优先事项、利益相关者一致性|
|团队负责人|协调、代码审查、质量|
|架构师|系统设计、技术决策、结构完整性|
|后端开发人员| API、数据库、服务器逻辑|
|前端开发人员|仪表板组件,UI/UX|
|开发人员|跨前端和后端的全栈功能|
|QA工程师|测试、验证、质量门|
|安全工程师|漏洞审查、威胁建模、安全最佳实践|
|DevOps | CI/CD、构建、部署|
通过MCP工具或在仪表板中单击一次即可添加、删除或交换模型。
______________________________________________________________________
## Sprint流程
强制门检查的4个阶段:```
planning → implementation → done → rest
| 阶段 | 持续时间 | 闸门 |
|---|---|---|
| 规划 | 1天 | 已分配门票,承诺速度 |
| 实施 | 3天 | 所有门票已完成或未完成,堵塞者已解决 |
| 完成 | 0.5天 | 记录追溯结果,QA验证 |
| 休息 | 0.5天 | 恢复后自动 |
阶段、持续时间和门可以通过以下方式完全定制 update_sprint_config.
技术栈
| 层 | 技术 |
|---|---|
| 运行时 | Node.js 24 LTS |
| 数据库 | SQLite通过better-splite3,WAL模式 |
| MCP协议 | @人工智能/sdk |
| 仪表板 | React 19+Vite+Zustand+Framer Motion |
| 样式 | CSS变量+顺风,深色主题 |
| 实时更新 | SSE通过WAL文件监视器 |
| 测试 | Vitest |
| 构建 | TypeScript严格模式 |
发动机编号
| 组件 | 计数 |
|---|---|
| MCP工具 | 76(32读+44写) |
| 数据库表 | 30(25个scrum+5个代码) |
| 反应组件 | 62 |
| 代理角色 | 9(可配置) |
| 冲刺阶段 | 4,带关卡检查 |
| Slash命令 | 6 |
手动MCP服务器设置
如果自动 .mcp.json 安装程序不起作用:```bash
Add to current project
claude mcp add code-context npx -y vlm-code-context-mcp ./context.db
Add globally
claude mcp add --scope user code-context node /path/to/node_modules/vlm-code-context-mcp/dist/server/index.js ./context.db
Remove
claude mcp remove code-context
______________________________________________________________________
## 发展```bash
# MCP server
npm run dev
# Dashboard (Vite dev server with HMR)
npm run dashboard:dev
许可证
麻省理工学院
