code-context-mcp
vlm-code-context-mcp
AIコーディングエージェントのための永続メモリ。
エージェントはセッション間の記憶をすべて忘れてしまいます。これを解決します。
npm install vlm-code-context-mcp
npx code-context-mcp setup .
claude mcp add code-context npx -y vlm-code-context-mcp ./context.db3つのコマンド。APIキーはゼロ。1つの context.db ファイル。
ベンチマーク
10個の実際の開発タスク(取得、デバッグ、リファクタリング、実装)でテストし、200回のランダム化試行とウィルコクソンの符号付順位検定で検証しました。
MCP | Vanilla | 削減率 | |
トークン数 | 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-mcp2 · 初期化
npx code-context-mcp setup .context.db を作成し、コードベースをインデックス化し、7人のエージェントチームをシードし、.mcp.json を書き込みます。
3 · AIクライアントの再起動
Claude Code(または任意のMCPクライアント)を再起動します。get_project_status で確認してください。
4 · ダッシュボードの起動
npx code-context-dashboard ./context.dbhttp://localhost:3333 で開き、ライブSSE更新が行われます。ファイル保存時に自動再インデックスを行うには:
npx code-context-dashboard ./context.db 3333 .5 · 最初のスプリントを実行
Claude Codeで以下を入力します:
/kickoffオーケストレーターが、ビジョン → 発見 → マイルストーン → エピック → チケット → スプリント → 実装 → レトロスペクティブまで、1つずつ質問しながら案内します。スマートレジューム機能により、中断して後で再開できます。
ダッシュボード
7ページ。ライブSSE更新。ポーリング不要。
ページ | 表示内容 |
Dashboard | かんばんボード、フェーズゲートステッパー、バーンダウン、ベロシティ、スプリントチェックリスト |
Planning | マイルストーントラッカー、エピックの進捗、発見パイプライン |
Code | ファイルツリー、依存関係グラフ、エクスポート/インポートマップ、変更履歴 |
Team | エージェントカード、モデルバッジ、ムードトレンド、ワークロードバー |
Retro | ベントグリッドのインサイト、スプリント間のパターン、繰り返されるテーマ |
Benchmark | アニメーション付きメトリクスによるMCPとVanillaの比較 |
Velocity | スプリントごとのトレンド、コミット済み対完了済み |
データベースの変更はすべて、SQLite WAL監視を通じて即座にリフレッシュをトリガーします。
スラッシュコマンド
Claude Codeで直接入力してください。
コマンド | 動作 |
| ガイド付きの完全なライフサイクル(ビジョンからレトロまで)。ここから開始してください。 |
| スプリント専用ループ(計画 → 実装 → QA → レトロ → アーカイブ) |
| 完全なコンテキストでチケットをライフサイクルに沿って移動 |
| エピック検証付きでマイルストーンを作成、更新、クローズ |
| バーンダウンとベロシティ分析を備えたデータ駆動型のレトロスペクティブ |
| ダッシュボード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フェーズ | 期間 | ゲート |
Planning | 1日 | チケット割り当て済み、ベロシティコミット済み |
Implementation | 3日 | すべてのチケットがDONEまたはNOT_DONE、ブロッカー解決済み |
Done | 0.5日 | レトロスペクティブの結果を記録、QA検証済み |
Rest | 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、ダークテーマ |
ライブ更新 | WALファイルウォッチャー経由のSSE |
テスト | Vitest |
ビルド | TypeScript strictモード |
エンジン数値
コンポーネント | 数 |
MCPツール | 76 (読み取り32 + 書き込み44) |
データベーステーブル | 30 (スクラム25 + コード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
Maintenance
Related MCP Connectors
Coding agents in multi-service codebases routinely rebuild existing helpers, trust stale type definitions, and modify API contracts without knowing who consumes them. Carrick solves this by indexing your entire TypeScript ecosystem across service and repository boundaries. By integrating deeply with the TypeScript compiler, Carrick traces every route, type, and cross-service call while recording function behaviour so agents search by intent rather than name. Delivered via MCP for AI agents and LSP for IDEs, Carrick ensures models see existing endpoints and utilities before generating new code. The scanner is source-available and runs from your CLI or CI pipeline.
Stateless TS/JS compiler facts for agents: references, imports, impact. No repo index or OAuth.
Repository knowledge graph MCP server for codebase understanding and debugging.
Hosted code graph over MCP: exact callers, dependencies, and cross-repo blast radius for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides 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.-
- FlicenseBqualityDmaintenanceAn 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-
- AlicenseAqualityCmaintenanceIndexes 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.722 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn 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