このプロジェクトについて

ContextAtlasは、Claude Codeにコードベースの事前計算済み「アトラス」を提供するMCPサーバーであり、アーキテクチャに関する質問に対して、多数のgrepやファイル読み取り呼び出しではなく、1つの統合されたコンテキストバンドルから回答できるようにします。 機能 - インデックス時に、ADR、README、設計ドキュメント、エクスポートされたシンボルのdocstring、フィルタリングされたgitコミットメッセージから構造化された主張を抽出し、特定のコードシンボルに関連付けます。 - クエリ時に、シンボルごとに4つのシグナルを統合します。LSP構造データ(定義、参照、型、診断)、アーキテクチャ意図の主張、git履歴(最近のコミット、hot/cold、共変更)、テストの関連付けです。 - 3つのMCPツールが公開されています。get_symbol_context(既知のシンボルの完全なバンドル、最大10個のマルチシンボルモード対応)、find_by_intent(ローカルSQLite FTS5上のインデックス済み主張テキストに対するBM25検索)、impact_of_change(共変更とテスト影響を用いたブラスト半径)です。 - クエリ解決はローカルで行われます。SQLiteルックアップとローカル言語サーバー呼び出しのみで、通常使用中にネットワークトラフィックやモデル呼び出しは発生しません。 言語サポート TypeScript、Python、Go、Ruby、C#は、言語サーバー(typescript-language-server、Pyright、gopls、ruby-lsp、csharp-ls)を通じてサポートされており、これらはユーザーがインストールするピア依存関係です。Node.js 20以上が必要です。 2つのセットアップ方法 - Skillsパス:パッケージをインストールし、initを実行してから、Claude Code内で /generate-adrs、/index-atlas、/prime-atlas を使用します。APIキーは不要です。 - CLIパス:インストールし、ANTHROPIC_API_KEYを設定し、init、generate-adrs、index、doctorを実行します。 docs/adr/ 以下に既にADRがあるリポジトリは、既存のADRが自動的に抽出されるため、generate-adrsをスキップできます。 コミットされたアトラスのパターン 生成されたatlas.jsonは、コードやADRとともにリポジトリにコミットすることを意図しています。リポジトリをクローンしたチームメイトは、抽出を再実行することなく、それを直接ローカルキャッシュにインポートでき、コントリビューターはアーキテクチャ上の主張に影響する変更があった場合に再生成できます。コミットできないチームは、atlas.committed: false を設定し、各開発者が独自に抽出を実行できます。 プライバシーに関する注意 インデックス時に、設定で一致したADR/ドキュメントファイル、エクスポートされたシンボルのdocstringテキスト、フィルタリングされたコミットメッセージがAnthropic APIに送信されます。ソースコード、それらのメッセージ以外のgit履歴、LSPデータ、実行時のクエリ内容は送信されません。ソースファイルに一致するdocs.include globを指定すると、それらのファイル全体が送信されます。抽出ストリームは制限できます(たとえばADRのみに)。抽出されたすべての主張とクエリ解決はローカルのSQLiteファイルに留まります。 報告されているベンチマーク READMEには、honojs/hono、encode/httpx、spf13/cobraに対するベンチマークスイートが、事前登録されたプロンプトとブラインド評価で報告されており、アーキテクチャ意図プロンプトで45~72%のトークン削減、honoの参照実行でツール呼び出しが全体で39%削減されたと引用されています。また、品質デeltas(事実正確性、ハルシネーション、実行可能性、完全性)を信頼区間付きで報告し、tieおよびtrickプロンプトバケットではContextAtlasがネットネガティブであったと述べており、著者らはこれを予想通りとしています。これらの数値はプロジェクト自身のベンチマークリポジトリに由来し、著者報告であり、独立して検証されたものではないと扱うべきです。 ステータスとライセンス READMEには、v0.9.0が2026-05-16にリリースされ、パッケージはまだnpmに公開されていないため、インストール手順は意図された形を説明していると記載されています。MITライセンス。