Ermöglicht es AI Coding Agents, Repository-Strukturen zu inspizieren, Code zu durchsuchen und Projekt-Konventionen via MCP und CLI abzurufen.
Auch bekannt als PatrickSys/codebase-context
- Stars
- 68
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 7. Nov. 2026
- Lizenz
- —
Was ist Codebase Context MCP?
Codebase Context ist ein MCP server. Ermöglicht es AI Coding Agents, Repository-Strukturen zu inspizieren, Code zu durchsuchen und Projekt-Konventionen via MCP und CLI abzurufen.
Zusammenfassung generiert aus dem README des Projekts
Über Codebase Context MCP server
codebase-context hilft AI Coding Agents dabei, komplexe Repositories durch spezialisierte Indexing- und Retrieval-Tools zu verstehen. Entwickler nutzen dieses Tool, um Agents eine High-Level-Repository-Map, Symbol-Referenzen und Datei-Beziehungen zur Verfügung zu stellen, sodass eine KI die Projektstruktur inspizieren kann, bevor sie Änderungen vornimmt. Es funktioniert lokal via stdio oder über ein erweitertes HTTP-Setup und kann für spezifische Clients wie Claude Code, Cursor, Codex und OpenCode initialisiert werden.
Nutzer können zwischen einem standardmäßigen keyword-basierten Index wählen, der keine API-Keys oder GPU benötigt, oder einem optionalen semantischen Indexing-Modus, der Embedding-Provider nutzt. Das System enthält einzigartige Features wie Project Memory zum Speichern von Konventionen und ein Review-Context-Tool, das aus Git-Diffs ein abgegrenztes Datenpaket erstellt. Während der Keyword-Index standardmäßig auf 5.000 durchsuchbare Chunks begrenzt ist, können Nutzer diese Limits über die Config anpassen. Es bietet spezifische Analyzer für Frameworks wie React, Next.js, Angular und NestJS, um die Navigation in Codebases für Agents zu verbessern.
Was du damit machen kannst
- 1Repository-Struktur mappenLass einen AI Agent eine High-Level-Übersicht der Projektorganisation und der Patterns erstellen, bevor er mit einer Aufgabe beginnt.
- 2Nach spezifischem Code suchenLeite eine KI an, spezifische Symbole oder Features innerhalb der Codebase mithilfe von gewichteten Suchergebnissen zu finden.
- 3Projekt-Konventionen abrufenWeise einen Agent an, zuvor gespeicherte Entscheidungen oder Architektur-Regeln über die Memory-Tools abzurufen.
- 4Aktuelle Änderungen analysierenVersorge eine KI mit dem notwendigen Kontext aus einem aktuellen Commit, um ein fokussiertes Code-Review durchzuführen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Codebase Context MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenCodebase Context MCP in Claude Code installieren
$ claude mcp add codebase-context -- npx -y codebase-contextCodebase Context MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"codebase-context": {
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}Codebase Context MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"codebase-context": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}Codebase Context MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"codebase-context","type":"stdio","command":"npx","args":["-y","codebase-context"]}'Codebase Context MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"codebase-context": {
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}Codebase Context MCP in Codex installieren
$ codex mcp add codebase-context -- npx -y codebase-contextCodebase Context MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.codebase-context] command = "npx" args = ["-y", "codebase-context"]
Codebase Context MCP in Gemini CLI installieren
$ gemini mcp add -s user codebase-context npx -- -y codebase-contextCodebase Context MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"codebase-context": {
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarpatricksys/codebase-context is public and reachablegithub.com/patricksys/codebase-context ↗Bestanden
- Paket nennt dieses Repository als Quellecodebase-context names patricksys/codebase-context as sourcenpmjs.com/package/codebase-context ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for codebase-contextnpmjs.com/package/codebase-context/v/2.2.0#provenance ↗Bestanden
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrLast commit or release 2026-11-07github.com/patricksys/codebase-context ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from codebase-contextBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenCodebase Context
Local repository maps, code search and symbol references for coding agents. Codebase Context exposes these through MCP and a CLI so an agent can inspect the repository before editing it.
Published beta: 2.3.1-beta.0 (stable: 2.2.0)
As checked on 4 November 2026, npm beta points to 2.3.1-beta.0, while npm latest remains 2.2.0. The beta requires Node.js 22 or newer. An unpinned npx -y codebase-context may use an already installed local version; without one, it resolves npm latest (currently the stable 2.2.0). To select the published beta explicitly, use npx -y codebase-context@2.3.1-beta.0 --version. A source checkout or a local tarball is separate from a verified registry release.
Fresh beta indexes use keyword search without downloading an embedding or reranker model. Existing indexes keep their recorded mode. Semantic indexing is an explicit option; its optional runtimes and model downloads are separate from the default path.
Try the beta or a local build from the terminal
Use an explicitly installed 2.3.1-beta.0, a built checkout (pnpm install, then pnpm build in the CBC checkout) or an installed local tarball. From the repository you want to inspect, point Node at that installation's actual entrypoint:
node /path/to/codebase-context/dist/index.js --version
node /path/to/codebase-context/dist/index.js map
node /path/to/codebase-context/dist/index.js search --query "a symbol or feature in this repository" --limit 5
node /path/to/codebase-context/dist/index.js status
Replace the paths and query with your own. For a tarball installed under /path/to/cbc-local, the entrypoint is /path/to/cbc-local/node_modules/codebase-context/dist/index.js. Quote paths containing spaces.
map builds an index when the folder has no previous index. It then returns a bounded repository map. Search returns ranked source locations; open the returned code before relying on it. Low confidence means weak matching evidence, not that an implementation is absent.
To refresh the index, use reindex. Omitting mode flags preserves the recorded mode; reindex --no-embeddings explicitly selects keyword-only indexing. reindex --embeddings selects the configured embedding provider and requires optional LanceDB storage. The default local provider also requires Transformers and may download models; an explicitly configured remote provider has its own connection requirements. Changing modes requires a full rebuild, including when --incremental is supplied.
Set up your AI client
From the target repository, the installed beta or built source can write project registrations for selected detected clients:
node /path/to/codebase-context/dist/index.js init
# Or select one client explicitly:
node /path/to/codebase-context/dist/index.js init --client codex --root /path/to/project --yes
The wizard recognizes Claude Code, Codex, Cursor and OpenCode. It saves the Node binary and package entrypoint that ran setup. If that installation or its npx cache is moved or removed, rerun setup. Writing a config does not prove that a native client connected or completed a coding task.
After registration, restart the client and ask:
Use Codebase Context to find [feature] in this repository. Pass this repository's absolute path as project, wait for indexing if needed, and open the relevant source files.
The client setup guide contains beta setup instructions and dated checks for the older stable package. Historical manual recipes, including Windsurf, retain their dated verification limits. For example, the following manual registration leaves the package version unpinned; it may use an already installed local version or fall back to npm latest, so it does not reliably select the beta:
claude mcp add --scope user --transport stdio codebase-context -- npx -y codebase-context
The default transport is stdio: the client starts the server. HTTP is an advanced option with client-specific setup. Explicit project selection is the portable default. A successful selection becomes active for later calls in that server process; select again after restarting or changing repositories.
What your agent can inspect
- Repository map: structure, detected patterns and example files before narrowing to a task.
- Code search: bounded, ranked results with source locations and search-quality information. The default compact response contains at most six results.
- Symbol references: static identifier occurrences. They are not a runtime call graph.
- File relationships: TypeScript/JavaScript imports and re-exports, with unresolved or stale edges reported. Python and Go import navigation are not supported.
- Team patterns: file-level frequencies and example files. These are observations about the repository, not prescriptions about code quality.
- Project memory:
rememberandget_memorystore and retrieve project conventions, decisions, gotchas and failures. - Review context:
codebase-context-reviewbuilds a bounded packet from a committed Git diff. It does not review code or establish reviewer quality. The review-context guide retains a separate historical version preview; it is not evidence of this candidate's publication.
Dedicated analyzers in the source cover Angular, React, Next.js and NestJS. Other files use the generic analyzer and available parsers. See the capabilities reference for scope and limitations.
Privacy and storage
The default keyword index is built locally. Docker, a GPU and an API key are not required. Optional local embeddings also run on the machine. If you explicitly configure a remote embedding provider, code chunks are sent to that provider.
Your AI client may send returned code to its own model provider; CBC does not control that connection. Project memory also travels with the repository if you commit and push it.
Generated index data should stay out of version control. To share project memory while ignoring the generated index:
.codebase-context/*
!.codebase-context/memory.json
Evidence and limits
The benchmark report and prior report archive describe separate historical experiments. These are retrieval observations, not a winner or a coding-quality claim. This historical evidence does not establish patch correctness or end-to-end coding quality. Versions, fixtures and failure records matter; these reports do not certify this candidate. This draft makes no claim that CBC beats text search, improves coding outcomes, or reduces time or tokens.
The default keyword path can miss natural-language questions when their vocabulary differs from the code. A returned file and a high score are not proof that an answer is correct. Inspect the cited implementation. Optional semantic search has not established a retrieval-quality advantage for this candidate.
Other practical limits:
- The default keyword index holds at most 5,000 searchable chunks per project.
projects[].parsing.maxChunkscan raise that limit. - Search has bounded candidate inspection. Narrow a query when the candidate budget is exhausted; refresh when source files changed or became unavailable.
- Existing formats or incomplete generations can require an explicit rebuild or recovery choice. A failed operation is not a successful recovery.
- Setup evidence differs by client. Config writing, protocol connectivity and native-client task completion are separate checks.
- Stdio routing checks do not establish concurrent HTTP client isolation.
Reference
- Client setup — candidate registration, dated checks and limits
- Capabilities — tools, routing, configuration and optional modes
- CLI — local-candidate commands and historical illustrations
- Benchmark — historical methods, observations and failures
- Contributing — local development and evaluation commands
- Changelog — candidate changes and historical entries
Elastic-2.0. See LICENSE.
Codebase Context MCP Fragen
Wie füge ich Codebase Context MCP zu Claude Code hinzu?
Führe claude mcp add codebase-context -- npx -y codebase-context in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Codebase Context MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was kann ein AI Agent mit Codebase Context inspizieren?
Der Agent kann eine Repository-Map einsehen, eine gewichtete Code-Suche ausführen, Symbol-Referenzen und Datei-Beziehungen nachschlagen, Team-Patterns beobachten sowie Projekt-Memory speichern oder abrufen.
Benötigt Codebase Context Docker, eine GPU oder einen API-Key?
Nein. Der standardmäßige Keyword-Index wird lokal ohne Docker, GPU oder API-Key erstellt. Optionale Embeddings laufen ebenfalls lokal, sofern du nicht explizit einen Remote-Provider konfigurierst.
Welche AI Clients können mit Codebase Context automatisch eingerichtet werden?
Der Init-Wizard erkennt Claude Code, Codex, Cursor und OpenCode und schreibt die entsprechenden Projekt-Registrierungen für sie.
Wie viele Ergebnisse liefert eine standardmäßige Code-Suche?
Die standardmäßige kompakte Suchantwort enthält maximal sechs gewichtete Ergebnisse.
Sollten die generierten Index-Daten in die Versionskontrolle committet werden?
Nein. Du solltest die generierten Index-Daten aus der Versionskontrolle heraushalten und kannst optional nur die Project-Memory-Datei committen.