Skip to main content
Glama
deenesjakoruzh
VelimirMueller

code-context-mcp

by VelimirMueller
OverviewSchemaRelated ServersScoreDiscussions
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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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
    C
    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
    B
    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
    MIT

  • codegraph-mcp

    SiwarKhalfaoui
    A
    license
    A
    quality
    C
    maintenance
    An MCP server that indexes TypeScript/JavaScript codebases into precise call and import graphs using the TypeScript compiler API, allowing Claude or any MCP client to query definitions, callers, callees, and perform impact analysis.
    7
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VelimirMueller/vlm-code-context-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server