Community研究&データ分析github.com

sdsrss/code-graph-mcp

Claude Code用のAST知識グラフMCPサーバー。セマンティック検索、コールグラフ探索、HTTPルートトレース、影響分析を提供。Tree-sitterにより10言語を自動インデックス。

code-graph-mcp とは?

`sdsrss/code-graph-mcp`は、Claude Codeエージェントと連携してコードベースの構造的・意味的な理解を深めるためのMCP(Model Context Protocol)サーバーです。Tree-sitterを使用してPython、JavaScript、TypeScript、Rust、Go、Java、Ruby、C、C++、PHPの10言語のAST(抽象構文木)を自動的に解析し、知識グラフとしてインデックス化します。このサーバーは、関数定義の検索やクラス階層の追跡といったセマンティック検索、関数やメソッド間の呼び出し関係を可視化するコールグラフ探索、WebフレームワークにおけるHTTPルートのトレース、変更影響分析など、高度なコード解析機能を提供します。また、コードベース全体のグラフ表現を取得し、開発者がコードの構造を俯瞰的に把握するのを支援します。開発者はClaude CodeからこのMCPサーバーにアクセスすることで、コードの探索、理解、リファクタリング、バグ発見などのタスクを効率的に実行できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add sdsrss/code-graph-mcp

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

code-graph-mcp は何をしますか?

Claude Code用のAST知識グラフMCPサーバー — セマンティック検索、コールグラフ探索、HTTPルートトレース、影響分析を提供。Tree-sitterにより10言語を自動インデックス。

機能

  • セマンティック検索: 関数名やクラス名でなく、意味的な関連性に基づいてコード要素を検索。
  • コールグラフ探索: 関数呼び出しの関係をグラフとして辿り、依存関係を可視化。
  • HTTPルートトレース: Webフレームワーク(Express、Rails、Djangoなど)のルーティングを解析し、リクエストからハンドラまでを追跡。
  • 影響分析: コード変更が他の部分に与える影響を、グラフ構造から推定。

サポート言語

  • Python
  • JavaScript
  • TypeScript
  • Rust
  • Go
  • Java
  • Ruby
  • C
  • C++
  • PHP

使い方

Claude CodeのMCP設定ファイル(~/.claude/mcp.json)またはプロジェクトの.claude/mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "code-graph": {
      "command": "npx",
      "args": [
        "-y",
        "@sdsrss/code-graph-mcp"
      ],
      "env": {
        "CODE_GRAPH_DIR": "./code-graph"
      }
    }
  }
}

環境変数

  • CODE_GRAPH_DIR: 知識グラフデータの保存先ディレクトリ(デフォルト: ./code-graph)

ツール一覧

ツール名説明
search_codeセマンティック検索を実行
get_call_graph特定の関数のコールグラフを取得
trace_http_routeHTTPエンドポイントからハンドラまでをトレース
analyze_impact指定されたコード変更の影響分析を実行
get_graph_summaryコードベース全体のグラフ概要を取得

動作例

# セマンティック検索の例
> search_code(query="ユーザー認証", language="python")

# コールグラフ探索の例
> get_call_graph(function_name="authenticate_user", depth=3)

# HTTPルートトレースの例
> trace_http_route(method="POST", path="/api/login")

ライセンス

MIT

関連スキル