Constellation について
Constellationは、AIコーディングエージェント向けのコードインテリジェンスMCPサーバーです。ソースコードを送らずに構造や関係を提供し、ローカルCLIがコードを解析してメタデータを送信します。
主な機能
- 01関数・クラス・インポート・参照の解析
- 02構造メタデータに基づくコード情報の生成
- 03生のソースコードをローカルに保持
- 04Gitブランチごとのコード情報管理
- 05リクエスト時のAPIキー認証
活用シーン
- 01AIコーディングエージェントへのコード関係の質問
- 02構造情報を使ったコードベースの把握
- 03ブランチ別コード情報の照会
MCP 対応
MCPサーバーは、AIアシスタントがConstellationのコードナレッジグラフを照会するツールを公開します。ローカルCLIがコードを解析し、ソースコードではなくメタデータを送信します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| code | string | はい | 実行する JavaScript コード。トップレベルの await を使用できます。利用可能な API メソッド:searchSymbols、getSymbolDetails、getDependencies、getDependents、findCircularDependencies、traceSymbolUsage、getCallGraph、impactAnalysis、findOrphanedCode、getArchitectureOverview |
| cwd | string | はい | 照会対象のプロジェクトディレクトリの絶対パス。git リポジトリのルートを特定して、正しい constellation.json を見つけるために使用します。作業中のリポジトリのルートまたはワークスペースフォルダーを設定してください。 |
| timeout | number | いいえ | 最大実行時間(ミリ秒)(デフォルト:30000、最大:60000) |
詳細
Constellation MCP Server
ソースコードを一切送信することなく、AI コーディングアシスタントがコードベース全体の構造、依存関係、関連性にすぐに、かつインテリジェントにアクセスできるようにします。Constellation は、AI コーディングアシスタントツールにコードインテリジェンスをサービスとして提供します。
クイックスタート
AI アシスタントのプロジェクトレベルの設定(ツールがプロジェクトレベルの設定に対応していない場合はシステムレベルの設定)に、Constellation MCP サーバーを追加します。
{
"mcpServers": {
"constellation": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@constellationdev/mcp@latest"],
"env": {
"CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}"
}
}
}
}
メモ
上記は、VSCode や Claude Code など一部のツールで使用される.mcp.jsonファイルの汎用的な形式です。MCP サーバーを直接設定するのではなく、最適なパフォーマンスと動作を得るために、公式の Constellation プラグインをインストールして利用することをおすすめします。
その他の AI アシスタントの設定方法については、MCP サーバー > インストールのドキュメントをご覧ください。
認証、プロジェクトのセットアップ、設定に関する詳しい手順については、公式ドキュメントをご覧ください。
動作の仕組み
%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#4A90E2', 'primaryTextColor': '#EEEEEE', 'primaryBorderColor': '#2B2C34', 'lineColor': '#4A90E2', 'secondaryColor': '#1F1F28', 'tertiaryColor': '#0B0C10', 'edgeLabelBackground': '#1F1F28' }}}%%
flowchart LR
subgraph local["💻 Your Environment"]
direction TB
code["📂 Source Code"]
cli["⚙️ Constellation CLI"]
ai["🤖 AI Coding Assistant"]
mcp["🧩 Constellation MCP"]
code --> cli
end
subgraph cloud["✨ Constellation Service"]
direction TB
api["🔌 API"]
graphdb[("🧠 Knowledge Graph")]
api <--> graphdb
end
cli a1@-->|"Metadata Upload"| api
ai <-->|"Tool Calls"| mcp
mcp a2@<-->|"Queries"| api
a1@{ animation: fast }
a2@{ animation: fast }
style local fill:#1F1F28
style cloud fill:#1F1F28,stroke:#4A90E2
style cli stroke:#4A90E2
style mcp stroke:#4A90E2
style api stroke:#4A90E2
style graphdb stroke:#4A90E2
- 解析と分析:CLI ツールがお使いの環境でソースコードを分析し、構造メタデータ(関数、クラス、変数、インポート、呼び出し、参照など)を抽出します。
- アップロード:メタデータのみを Constellation に安全に送信します。生のソースコードは一切送信しません。
- クエリ:AI アシスタントは Constellation MCP ツールを使って複雑なクエリを送信し、ナレッジグラフから導き出された回答をすばやく取得します。
ドキュメント
詳細なドキュメントは docs.constellationdev.io/mcp/ をご覧ください。
- インストールとセットアップ - Claude Code、Cursor、GitHub Copilot などの設定方法
- ツールリファレンス - Code Mode API と利用可能なメソッド
- トラブルシューティング - よくある問題と解決方法
プライバシーとセキュリティ
- ソースコードの送信なし - メタデータと関連性のみを送信します
- アクセス制御 - すべてのリクエストに API キーが必要です
- ブランチの分離 - 各 git ブランチは個別のコードインテリジェンスを保持します
プライバシーとセキュリティについて詳しくは、公式プライバシーとセキュリティのドキュメントおよびプライバシーポリシーをご覧ください。
サポート
- ドキュメント:docs.constellationdev.io
- 問題の報告:GitHub Issues
ライセンス
AGPL-3.0 - 詳細は LICENSE をご覧ください。
Copyright © 2026 ShiftinBits Inc.
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。