Debug Adapter Protocol (DAP)

🚀 dap-mcp

dap-mcp は、デバッグアダプタープロトコル（DAP）セッションを管理するためにカスタマイズされたモデルコンテキストプロトコル（MCP）の実装です。MCP は、大規模言語モデルのコンテキストウィンドウを最適化および拡張するための標準化されたフレームワークを提供し、このプロジェクトではデバッグワークフローを強化および簡素化するために使用されます。

✨ 主な機能

• デバッグアダプタープロトコルの統合: 標準化されたプロトコルを使用してデバッガーとやり取りします。
• MCP フレームワーク: MCP を利用してコンテキストを最適化し、デバッグワークフローを向上させます。
• 充実したデバッグツール: ブレークポイントの設定、一覧表示、削除；実行の制御（続行、ステップイン/アウト/ネクスト）；式の評価；コールスタックの切り替え；ソースコードの表示。
• 柔軟な設定: JSON 設定ファイルを通じてデバッガーの設定、ソースコードディレクトリ、その他のパラメータをカスタマイズできます。

📦 インストール

前提条件

• Python 3.10 以上
• uv（サーバーを実行する場合、オプション）

サーバーのインストールと実行

dap-mcp とその依存関係をインストールします：

pip install dap-mcp
python -m dap_mcp --config config.json

# または、uv をインストールしている場合
uvx dap-mcp@latest --config config.json

📚 ドキュメント

設定

プロジェクトは JSON 設定ファイル（例：.config.json）を使用して、デバッガーの設定とソースコードディレクトリを指定します。設定例：

{
  "type": "debugpy",
  "debuggerPath": "/path/to/python/with/debugpy",
  "debuggerArgs": [
    "-m",
    "debugpy.adapter"
  ],
  // ソースコードディレクトリ、ファイルパスの解決に使用
  // 常に絶対パスを使用する場合はこの設定を省略できます
  "sourceDirs": [
    "/path/to/source/code"
  ],
  // デバッガー固有の設定はここから始まります
  // debugpy の設定については https://debugpy.readthedocs.io/en/latest/ を参照してください
  // 設定オプションには以下が含まれます：
  // - debug: デバッグ機能を有効にする（デフォルト値：true）
  // - jitter: デバッグ開始のジッター時間を制御する（範囲：0 から 100 ミリ秒、デフォルト値：25）
}

利用可能なツール

• dap-mcp
  • バージョン: v1.0.0
  • 説明: dap-mcp は、デバッグアダプタープロトコル（DAP）セッションに特化した MCP の実装です。

デバッガーの設定

# 設定ファイルを使用して dap-mcp を実行する
python -m dap_mcp --config config.json

他の DAP サーバーへの拡張サポート

他の DAP サーバーへのサポートを追加するには、以下の手順を実行します：

1. 新しい Python ファイル（例：mydap_server.py）を作成し、DAP プロトコルと互換性のあるデバッガークラスを定義します。
2. 新しいデバッガーの設定を解析および検証するための設定スキーマを定義します。設定スキーマの定義方法については、こちら を参照してください。
3. dap_mcp/config.py ファイルの型ユニオン（Union）を更新して、新しいデバッガークラスを含めます：

from typing import Union

class MyDAPServer(Debugger):
    # 新しいデバッガークラスを定義する

Debugger = Union[Debugpy, Vscode, Gdb, MyDAPServer]

4. これで、"type": "mydapserver" を含む設定ファイルを提供すると、dap-mcp は自動的に新しいデバッガーの実装を解析して使用します。

コントリビューション

コントリビューションを歓迎します！コントリビュートするには、以下の手順に従ってください：

1. リポジトリをフォークします。
2. 機能または修正のための新しいブランチを作成します。
3. テストを記述し、すべてのチェックが通過することを確認します。
4. プルリクエストを送信します。 コーディング規約に従い、変更に適切なテストを含めてください。

📄 ライセンス

このプロジェクトは AGPL-3.0 ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。