vlm代码上下文mcp
AI编码代理的持久内存。
你的代理人在两次会议之间忘记了一切。这解决了这个问题。
 ](https://www.npmjs.com/package/vlm-code-context-mcp) ](https://www.npmjs.com/package/vlm-code-context-mcp)
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\ |
Reproduce it yourself
# 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·安装
npm install vlm-code-context-mcp2·初始化
npx code-context-mcp setup .创造 context.db,为你的代码库建立索引,组建一个7个代理团队,并编写 .mcp.json.
3·重新启动AI客户端
重新启动Claude Code(或任何MCP客户端)。证实 get_project_status.
4·启动仪表板
npx code-context-dashboard ./context.db开放时间: http://localhost:3333 实时SSE更新。要在文件保存时自动重新索引,请执行以下操作:
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 安装程序不起作用:
# 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______________________________________________________________________
发展
# MCP server
npm run dev
# Dashboard (Vite dev server with HMR)
npm run dashboard:dev______________________________________________________________________
许可证
麻省理工学院
