Skip to main content
Glama
deenesjakoruzh
VelimirMueller

code-context-mcp

by VelimirMueller
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

vlm-code-context-mcp

为 AI 编程代理提供持久化记忆。

你的代理在会话之间会遗忘一切。这个工具解决了这个问题。

License: MIT npm version npm downloads

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

原生

节省

Token 消耗

4,806

8,726

44.9%

工具调用

49

68

27.9%

随机胜率

—

—

90.5% (p < 0.001)

MCP 工具返回结构化摘要（导出、依赖、文件角色）而不是原始文件内容。代理阅读更少，了解更多。

# 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

完整方法论请见 BENCHMARK-GUIDE.md。

Related MCP server: code-tree-mcp

快速开始

1 · 安装

npm install vlm-code-context-mcp

2 · 初始化

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 · 运行你的第一个冲刺 (Sprint)

在 Claude Code 中输入：

/kickoff

编排器将引导你完成愿景 → 发现 → 里程碑 → 史诗 → 工单 → 冲刺 → 实现 → 回顾 —— 一次一个问题。智能恢复功能让你随时停止并稍后继续。

仪表板

7 个页面。实时 SSE 更新。零轮询。

页面

显示内容

仪表板

看板、阶段进度条、燃尽图、速率、冲刺检查清单

规划

里程碑追踪器、史诗进度、发现流水线

代码

文件树、依赖图、导出/导入映射、变更历史

团队

代理卡片、模型徽章、情绪趋势、工作负载条

回顾

Bento 网格洞察、跨冲刺模式、重复出现的主题

基准测试

MCP 与原生的对比及动画指标

速率

冲刺间的趋势、已承诺与已完成

每一次数据库变更都会通过 SQLite WAL 监控触发即时刷新。

斜杠命令

直接在 Claude Code 中输入这些命令。

命令

功能

/kickoff

全流程引导 —— 从愿景到回顾。从这里开始。

/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 工具或在仪表板中单击即可添加、删除或更换模型。

冲刺流程

4 个阶段，带有强制门禁检查：

planning → implementation → done → rest

阶段

持续时间

门禁

规划

1 天

工单已分配，速率已承诺

实现

3 天

所有工单已完成 (DONE) 或未完成 (NOT_DONE)，阻塞项已解决

完成

0.5 天

回顾发现已记录，QA 已验证

休息

0.5 天

回顾后自动触发

阶段、持续时间和门禁可通过 update_sprint_config 完全自定义。

技术栈

层级

技术

运行时

Node.js 24 LTS

数据库

SQLite (通过 better-sqlite3), WAL 模式

MCP 协议

@anthropic-ai/sdk

仪表板

React 19 + Vite + Zustand + Framer Motion

样式

CSS 变量 + Tailwind, 深色主题

实时更新

SSE (通过 WAL 文件监视器)

测试

Vitest

构建

TypeScript 严格模式

引擎数据

组件

数量

MCP 工具

76 (32 读取 + 44 写入)

数据库表

30 (25 Scrum + 5 代码)

React 组件

62

代理角色

9 (可配置)

冲刺阶段

4 个带门禁检查

斜杠命令

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

许可证

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • local-code-intel-mcp

    tungvt93
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides code intelligence by indexing source code into SQLite and offering MCP tools for symbol search, flow tracing, and context retrieval to assist with code navigation and understanding.
    -

  • code-tree-mcp

    markgregg
    F
    license
    B
    quality
    D
    maintenance
    An MCP server that indexes source code into a local database and provides tools for querying code symbols, dependencies, and tree structure for JavaScript/TypeScript, Java, and Python.
    7
    -

  • code-graph-mcp

    dorkian
    A
    license
    A
    quality
    C
    maintenance
    Indexes a mono-repo into a knowledge graph and provides MCP tools to query code structure—packages, components, routes, HTTP calls—without file reads or grep round-trips.
    7
    22 npm
    MIT

  • Codebase Intelligence MCP

    S-naruka
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that indexes a local Python codebase into a SQLite graph for hybrid code search, file context, lazy explanations, dependency traces, and version-aware symbol history.
    MIT