Dap MCP

🚀 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"
  ],
  // ソースコードのディレクトリ、ファイルパスの解決に使用
  // 常に絶対パスを使用する場合はこの設定を省略できます
  "sourceDirectories": [
    "src",
    "tests"
  ],
  // その他のデバッガ固有の設定
  "debuggerSettings": {
    "timeout": 3000,
    ".debugLine": true
  }
}

利用可能なデバッガの種類

現在サポートされているデバッガの種類は次の通りです。

ツール

MCP フレームワークを通じて次のツールを呼び出すことができます。

• ブレークポイントの設定: 指定された位置でプログラムの実行を一時停止します。
• ブレークポイントの一覧表示: 設定されたすべてのブレークポイントの情報を表示します。
• ブレークポイントの削除: 指定されたブレークポイントを削除します。
• 続行: プログラムの実行を再開します。
• デバッグ開始: デバッグモードに切り替え、コードを1行ずつ実行します。
• デバッグ終了: 現在のデバッグセッションを終了します。
• 次へ: 次の命令を実行します。
• 式の評価: 現在のコンテキストで式の値を計算します。
• 呼び出しスタックの切り替え: 異なる呼び出しスタック間で切り替えます。

拡張

他の DAP サーバーをサポートするように拡張するには、次の手順に従ってください。

1. dap_base.DAPProtocol を継承する新しいデバッガクラスを作成します。

   class MyDAP(dap_base.DAPProtocol):
       def __init__(self, ...):
           super().__init__(...)
   
       def on_request(self, request):
           # 具体的なリクエストロジックを処理する
   

2. 設定の検証と解析部分を更新し、新しいデバッガの種類を追加します。

   debugger_type = Schema(
       {"type": "mydap"},
       Field(..., description="カスタムデバッガの設定")
   )
   

3. main 関数で新しいデバッガの実装を登録します。

   def main():
       ...
       if config.type == "mydap":
           dap_protocol = MyDAPProtocol(...)
       ...
   

コントリビューション

コントリビューションを歓迎します！プロジェクトに参加するには、次の手順に従ってください。

1. リポジトリをフォークします。
2. 新しい機能または修正のための新しいブランチを作成します。
3. テストを書き、すべてのチェックが通過することを確認します。
4. プルリクエストを送信します。

コーディング規約に従い、変更に適切なテストを含めてください。

📄 ライセンス

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