Ast MCP Server

🚀 AST MCP サーバー

抽象構文木（AST）と抽象意味グラフ（ASG）を通じて、コード構造と意味解析機能を提供する Model Context Protocol (MCP) サーバーです。コードの解析や構造分析、複雑度評価など、多様な機能を備えています。

✨ 主な機能

• コードを抽象構文木（AST）に解析する。
• コードから抽象意味グラフ（ASG）を生成する。
• コードの構造と複雑度を分析する。
• 複数のプログラミング言語（Python、JavaScript）をサポートする。
• Claude デスクトップ版や他の MCP クライアントと互換性がある。
• 大きなファイルをより高速に処理するための増分解析をサポートする。
• 強化されたスコープ処理とより完全な意味解析を行う。
• AST 差分を用いてコードバージョン間の変更を識別する。

📦 インストール

1. このリポジトリをクローンします：

git clone https://github.com/yourusername/ast-mcp-server.git
cd ast-mcp-server

2. uv を使って環境を設定します：

# uv がまだインストールされていない場合は、先にインストールしてください
# pip install uv

# 仮想環境を作成してアクティブ化する
uv venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

# 依存関係をインストールする
uv pip install -r requirements.txt

3. パーサーをビルドします：

uv run build_parsers.py

💻 使用例

Claude デスクトップ版との連携

1. Claude デスクトップ版をこのサーバーを使用するように設定します。最も簡単な方法は、提供されている claude_desktop_config.json ファイルを使用することです：

{
  "mcpServers": {
    "AstAnalyzer": {
      "command": "uv",
      "args": [
        "--directory", "/absolute/path/to/ast-mcp-server",
        "run", "server.py"
      ]
    }
  }
}

2. /absolute/path/to/ast-mcp-server をシステムの実際の絶対パスに置き換えてください。
3. この設定を Claude デスクトップ版の設定に追加します：
   • macOS：~/Library/Application Support/claude-desktop/claude_desktop_config.json
   • Linux：~/.config/claude-desktop/claude_desktop_config.json
   • Windows：%APPDATA%\claude-desktop\claude_desktop_config.json%
4. Claude デスクトップ版を再起動して、新しい MCP サーバーを読み込みます。
5. Claude デスクトップ版で、AST ベースのコード分析ツールを使用できるようになります。

AST MCP サーバーは正常に動作しています。以下は検証済みの機能の概要です：

• 基本的な AST 解析：✓
• 増分解析サポート：✓
• 複雑度分析機能：✓

インストール手順の説明

AST MCP サーバーをインストールするには、以下の手順に従ってください：

1. リポジトリをローカルの開発環境にクローンします。
2. Python 仮想環境管理ツール uv を使って仮想環境を作成し、アクティブ化します。
3. 仮想環境でプロジェクトの依存関係をインストールします。これには tree-sitter 言語サポートライブラリやその他の必要なパッケージが含まれます。
4. ビルドスクリプトを実行して、サポートされているすべてのプログラミング言語のパーサーを初期化します。

Claude デスクトップ版との統合

設定が完了すると、Claude デスクトップ版は MCP プロトコルを通じてサーバーが提供する分析ツールにアクセスできるようになります。ユーザーはチャットウィンドウでコードスニペットを共有することができ、Claude はこれらのツールを利用して詳細な分析を行い、洞察を提供します。

開発とテスト

• ツール登録：サーバーは起動時にすべての利用可能なツールとリソースを MCP プロトコルに自動的に登録します。
• ローカル実行：すべてのツールの実行はユーザーのローカルデバイスで行われ、結果は Claude に返されて解釈と表示されます。

利用可能なツール

基本機能

1. コードを AST に解析する。
2. 対応する ASG を生成する。
3. 複雑度分析を行う。
4. 構文検証を行う。

高度な機能

1. 増分更新サポート。
2. スコープ分析の強化。
3. 異言語間呼び出しグラフの生成。
4. 依存関係分析。

追加の言語サポート

新しいプログラミング言語のサポートを追加するには、以下の手順を実行してください：

1. リポジトリに新しい言語の tree-sitter 構文定義ファイルを追加します。
2. ビルドスクリプト build_parsers.py を実行してパーサーを初期化します。
3. ツール登録ロジックを更新して、新しい言語のサポートを含めます。

🔧 技術詳細

AST MCP サーバーは Model Context Protocol (MCP) を通じて Claude デスクトップ版と接続します。起動時には以下の手順が行われます：

1. サービス初期化：Claude デスクトップ版は uv run を使ってサーバーを起動し、作業ディレクトリを指定します。
2. パーサーモジュールの読み込み：サーバーは tree-sitter 言語モジュールを読み込み、複数のプログラミング言語の解析をサポートします。
3. ツールとリソースの登録：すべてのツールとリソースが MCP プロトコルに登録されます。
4. 分析実行：Claude は MCP プロトコルを通じてこれらのツールを呼び出し、ユーザーが共有したコードを分析することができます。

📄 ライセンス

MIT