MCPとCLIを通じて、AIコーディングエージェントがリポジトリ構造の調査、コード検索、プロジェクト規約の呼び出しを行えるようにします。
別名 PatrickSys/codebase-context
- スター
- 68
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月7日
- ライセンス
- —
Codebase Context MCPとは
Codebase ContextはMCPサーバーです。 MCPとCLIを通じて、AIコーディングエージェントがリポジトリ構造の調査、コード検索、プロジェクト規約の呼び出しを行えるようにします。.
プロジェクトのREADMEから生成された概要
Codebase Context MCP server について
codebase-contextは、特化したインデックス作成および検索ツールを通じて、AIコーディングエージェントが複雑なリポジトリを理解できるように支援します。開発者はこのツールを使用して、エージェントにハイレベルなリポジトリマップ、シンボル参照、ファイル間の関係を提供でき、AIが編集を試みる前にプロジェクト構造を調査することを可能にします。stdio経由のローカル実行、または高度なHTTPセットアップを通じて動作し、Claude Code、Cursor、Codex、OpenCodeなどの特定のクライアント向けに初期化できます。
ユーザーは、APIキーやGPUを必要としないデフォルトのキーワードベースのインデックスか、エンベディングプロバイダーを使用するオプションのセマンティックインデックスモードを選択できます。このシステムには、規約を保存するためのプロジェクトメモリや、Git diffから限定的なパケットを作成するレビューコンテキストツールなどのユニークな機能が含まれています。キーワードインデックスはデフォルトで検索可能なチャンクが5,000個に制限されていますが、ユーザーは設定を通じてこれらの制限を調整できます。また、React、Next.js、Angular、NestJSなどのフレームワーク専用のアナライザーを提供しており、エージェントによるコードベースのナビゲーション精度を向上させます。
できること
- 1リポジトリ構造のマッピングタスクを開始する前に、AIエージェントにプロジェクトの構成やパターンのハイレベルな概要を生成させます。
- 2特定のコードの検索ランク付けされた検索結果を使用して、コードベース内の特定のシンボルや機能をAIに探させます。
- 3プロジェクト規約の呼び出しメモリツールを使用して、以前に保存された決定事項やアーキテクチャのルールをエージェントに取得させます。
- 4最近の変更の分析最近のコミットから必要なコンテキストをAIに提供し、焦点を絞ったコードレビューを実行させます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Codebase Context MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにCodebase Context MCPをインストール
$ claude mcp add codebase-context -- npx -y codebase-contextCursorにCodebase Context MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"codebase-context": {
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}VS CodeにCodebase Context MCPをインストール
.vscode/mcp.json
{
"servers": {
"codebase-context": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}VS Code CLIにCodebase Context MCPをインストール
$ code --add-mcp '{"name":"codebase-context","type":"stdio","command":"npx","args":["-y","codebase-context"]}'Claude DesktopにCodebase Context MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"codebase-context": {
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}CodexにCodebase Context MCPをインストール
$ codex mcp add codebase-context -- npx -y codebase-contextCodex config.tomlにCodebase Context MCPをインストール
~/.codex/config.toml
[mcp_servers.codebase-context] command = "npx" args = ["-y", "codebase-context"]
Gemini CLIにCodebase Context MCPをインストール
$ gemini mcp add -s user codebase-context npx -- -y codebase-contextGemini settings.jsonにCodebase Context MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"codebase-context": {
"command": "npx",
"args": [
"-y",
"codebase-context"
]
}
}
}自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能patricksys/codebase-context is public and reachablegithub.com/patricksys/codebase-context ↗合格
- パッケージがこのリポジトリをソースとして指定codebase-context names patricksys/codebase-context as sourcenpmjs.com/package/codebase-context ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for codebase-contextnpmjs.com/package/codebase-context/v/2.2.0#provenance ↗合格
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-07github.com/patricksys/codebase-context ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from codebase-context合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るCodebase 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のよくある質問
Codebase Context MCPをClaude Codeに追加するには
ターミナルでclaude mcp add codebase-context -- npx -y codebase-contextを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Codebase Context MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Codebase ContextでAIエージェントは何を調査できますか?
エージェントは、リポジトリマップの表示、ランク付けされたコード検索の実行、シンボル参照やファイル間の関係の確認、チームのパターン把握、およびプロジェクトメモリの保存や取得が可能です。
Codebase Contextの利用にDocker、GPU、またはAPIキーは必要ですか?
いいえ。デフォルトのキーワードインデックスは、Docker、GPU、APIキーを使用せずにローカルで構築されます。オプションのエンベディングも、リモートプロバイダーを明示的に設定しない限り、ローカルで実行されます。
Codebase ContextはどのAIクライアントを自動セットアップできますか?
初期化ウィザードがClaude Code、Codex、Cursor、OpenCodeを認識し、それらのプロジェクト登録を書き込みます。
デフォルトのコード検索では、いくつの結果が返されますか?
デフォルトのコンパクトな検索レスポンスには、最大6つのランク付けされた結果が含まれます。
生成されたインデックスデータをバージョン管理にコミットすべきですか?
いいえ。生成されたインデックスデータはバージョン管理から除外してください。オプションとしてプロジェクトメモリファイルのみをコミットすることができます。