Skip to main content
Glama

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

3つのコマンド。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-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 · 最初のスプリントを実行

Claude Codeで以下を入力します:

/kickoff

オーケストレーターが、ビジョン → 発見 → マイルストーン → エピック → チケット → スプリント → 実装 → レトロスペクティブまで、1つずつ質問しながら案内します。スマートレジューム機能により、中断して後で再開できます。


ダッシュボード

7ページ。ライブSSE更新。ポーリング不要。

ページ

表示内容

Dashboard

かんばんボード、フェーズゲートステッパー、バーンダウン、ベロシティ、スプリントチェックリスト

Planning

マイルストーントラッカー、エピックの進捗、発見パイプライン

Code

ファイルツリー、依存関係グラフ、エクスポート/インポートマップ、変更履歴

Team

エージェントカード、モデルバッジ、ムードトレンド、ワークロードバー

Retro

ベントグリッドのインサイト、スプリント間のパターン、繰り返されるテーマ

Benchmark

アニメーション付きメトリクスによるMCPとVanillaの比較

Velocity

スプリントごとのトレンド、コミット済み対完了済み

データベースの変更はすべて、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

フェーズ

期間

ゲート

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

Related MCP Connectors

Related MCP Servers

  • 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.
    -
  • F
    license
    B
    quality
    D
    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
    -
  • A
    license
    A
    quality
    C
    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 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An 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