PasNavigator MCP

Delphi/Pascal コードベースのセマンティックナビゲーションのための MCP サーバー。

長期的な設計は次のとおりです。

• CodeComparer のアイデアとコードを再利用する Delphi ベースのインデクサー/バックエンド

• プロジェクトのインデックス作成とシンボルナビゲーションツールを公開する薄い MCP サーバーレイヤー

• 生の grep 出力ではなく、AI エージェント向けのコンパクトなシンボルレベルの応答

現在のステータス

このリポジトリには以下が含まれています。

• Python MCP ツールサーフェスとプロセスアダプター

• delphi/vendor/codecomparer/ の下にベンダーされた CodeComparer/DelphiAST ソースを含む Delphi コンソールバックエンド

• ライブの CodeComparer リポジトリチェックアウトへの実行時依存はありません

Delphi インデクサーをコンパイルするには、DevExpress VCL がまだ必要です (DXVCL)。

ベンダーされたインポーターには、defines と unit_scopes がパーサーに到達するようにするためのローカルな変更がいくつか含まれています。それらは delphi/vendor/codecomparer/NOTICE.txt にリストされています。

ドキュメント:

• プロトコル: docs/delphi-backend-protocol.md

• Delphi ビルド: delphi/README.md

Related MCP server: Delphi Compiler MCP

ツール

• open_project, open_project_from_config

• project_status

• find_symbol — ランク付けされ、上限付き、total_count を報告

• get_symbol

• get_hierarchy

• get_descendants

• get_source

設定

プロジェクト設定の例:

{
  "project_name": "MyApp",
  "roots": [
    "E:/Work/MyApp/Source",
    "E:/Work/MyApp/Modules"
  ],
  "search_paths": [
    "E:/Libs/Common",
    "C:/RAD/Studio/22.0/source/vcl"
  ],
  "defines": ["MSWINDOWS", "VER350"],
  "unit_scopes": ["System", "Vcl", "Winapi"],
  "excludes": ["**/__history/**", "**/backup/**"]
}

開発

仮想環境を作成し、パッケージを編集可能モードでインストールします:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .

インメモリスタブでサーバーを実行します:

python -m pasnavigator_mcp

Delphi コンソールバックエンドと通信します (スタブビルド、DevExpress なし):

$env:PASNAVIGATOR_BACKEND = "delphi"
$env:PASNAVIGATOR_DELPHI_EXE = "E:\Github_dm75\PasNavigator_MCP\delphi\bin\Win32\Debug\PasNavigatorBackend.exe"
python -m pasnavigator_mcp

テストを実行します。コンパイルされたバックエンドを必要とするケースは、PasNavigatorBackend.exe が存在しない場合にスキップされます。残りは Python フェイクプロセスに対して実行されます:

python -m unittest discover -s tests

次のステップ

MCP レイヤー自体 (server.py, config.py) にはテストカバレッジがありません。これは、mcp 依存関係がこの環境でインストールできなかったためです。