code-context MCP server
Commit Nov 9, 2026Indexes codebases into a SQLite database to provide AI coding agents with persistent memory, dependency graphs, and a structured sprint process.
Also known as VelimirMueller/code-context-mcp, vlm-code-context-mcp
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is code-context MCP?
code-context indexes codebases into a SQLite database to provide AI coding agents with persistent memory, dependency graphs, and a structured sprint process.
Summary generated from the project's README
About code-context MCP server
Providing AI coding agents with a persistent memory of your codebase is what code-context-mcp achieves by indexing files into a local SQLite database. Instead of agents re-reading an entire repository during every session, they query a context.db file to understand file roles, exports, and dependents. This approach reduces the number of uncached tokens required for complex tasks and ensures that knowledge survives between different chat sessions.
Developers can choose between a lightweight code index featuring 6 tools or a comprehensive sprint process that adds 91 additional tools for a total of 97. The sprint process manages a 9-agent team through stages like discovery, milestones, epics, and retros. Users can monitor progress via a live React dashboard hosted on port 3333, which provides real-time updates using SSE. The system requires Node.js 22 or newer and operates with zero API keys, relying entirely on local indexing and the provided database file.
What you can do with it
- 1Maintain persistent codebase knowledgeGive your AI coding agents a memory of your codebase that survives the session.
- 2Execute structured development sprintsRun a full development lifecycle from initial vision through to the final retrospective.
- 3Reduce token consumptionMinimize the number of tokens used when asking questions about large import graphs.
- 4Monitor agent progress visuallyTrack the status of tickets and sprint progress through a real-time web interface.
Written from the project's README. Every use case is checked against a quote from it.
How to install code-context MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall code-context MCP in Claude Code
$ claude mcp add code-context-mcp -- npx -y vlm-code-context-mcpInstall code-context MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-context-mcp": {
"command": "npx",
"args": [
"-y",
"vlm-code-context-mcp"
]
}
}
}Install code-context MCP in VS Code
.vscode/mcp.json
{
"servers": {
"code-context-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vlm-code-context-mcp"
]
}
}
}Install code-context MCP in VS Code CLI
$ code --add-mcp '{"name":"code-context-mcp","type":"stdio","command":"npx","args":["-y","vlm-code-context-mcp"]}'Install code-context MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"code-context-mcp": {
"command": "npx",
"args": [
"-y",
"vlm-code-context-mcp"
]
}
}
}Install code-context MCP in Codex
$ codex mcp add code-context-mcp -- npx -y vlm-code-context-mcpInstall code-context MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.code-context-mcp] command = "npx" args = ["-y", "vlm-code-context-mcp"]
Install code-context MCP in Gemini CLI
$ gemini mcp add -s user code-context-mcp npx -- -y vlm-code-context-mcpInstall code-context MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"code-context-mcp": {
"command": "npx",
"args": [
"-y",
"vlm-code-context-mcp"
]
}
}
}Configuration
CODE_CONTEXT_ABSOLUTE_PATHSCODE_CONTEXT_PROFILECODE_CONTEXT_SKILLS_AUTOSYNCCODE_CONTEXT_TIMESTAMPSCODE_CONTEXT_TOOLSETSOVERDRIVE_FLAIR
| Name | Description | |
|---|---|---|
| CODE_CONTEXT_ABSOLUTE_PATHS | — | |
| CODE_CONTEXT_PROFILE | — | |
| CODE_CONTEXT_SKILLS_AUTOSYNC | — | |
| CODE_CONTEXT_TIMESTAMPS | — | |
| CODE_CONTEXT_TOOLSETS | — | |
| OVERDRIVE_FLAIR | — |
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablevelimirmueller/code-context-mcp is public and reachablegithub.com/velimirmueller/code-context-mcp ↗Pass
- Package names this repository as its sourcevlm-code-context-mcp names velimirmueller/code-context-mcp as sourcenpmjs.com/package/vlm-code-context-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/velimirmueller/code-context-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from vlm-code-context-mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub# Requires Node.js 22 or newer. Node.js 24 LTS is recommended.
npm install vlm-code-context-mcp
# The code index (default): 6 tools
npx code-context-reindex . --db ./context.db
claude mcp add code-context -- npx code-context ./context.db
# Or the sprint process instead: setup installs code-context-sprint, /kickoff, the dashboard
npx code-context-mcp setup .
npx code-context-dashboard ./context.db # optional: live dashboard on :3333
# override the watch directory (4th argument)
npx code-context-dashboard ./context.db 3333 .
/kickoff
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
# Simulated (no model, no cost)
pnpm run bench
# Agent (real model, real tokens; needs ZAI_API_KEY or DEEPSEEK_API_KEY)
pnpm run bench:live --provider glm
code-context MCP questions
How do I add code-context MCP to Claude Code?
Run claude mcp add code-context-mcp -- npx -y vlm-code-context-mcp in your terminal. Add --scope user to make it available in every project.
How do I add code-context MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this server require any API keys?
No, the server operates with zero API keys required.
How does the server store the codebase information?
It indexes your codebase into a single SQLite file named context.db.
Can I see a visual representation of the project status?
Yes, you can launch a live React dashboard on port 3333 to view updates via SSE.
What is the sprint process feature?
It runs a full 9-agent team process covering vision, discovery, milestones, epics, tickets, gates, and retros.