mcp-gdbserver

mcp-gdbserver

gdbserver を使用したリモートデバッグ用 MCP サーバーです。プロセス管理、ブレークポイント制御、ステップ実行、メモリ検査など、包括的なデバッグ機能を提供します。

インストール

pip install mcp-gdbserver

使用方法

from mcp_gdbserver import GdbDebugger

# Create debugger instance
debugger = GdbDebugger()

# Start gdbserver to debug a program
session = debugger.start_gdbserver(port=2345, program="/bin/myapp", args=["--debug"])

# Get session info
sessions = debugger.list_sessions()

# Stop session
debugger.stop_session("session_1")

CLI

mcp-gdbserver --help

ツール

MCP サーバーは、4 つのカテゴリに分類された 19 個のデバッグツールを提供します。

プロセス管理

• gdbserver_start - プログラムをリモートでデバッグするために gdbserver を起動します
• gdbserver_start_multi - マルチプロセスモードで gdbserver を起動します
• gdbserver_attach - 実行中のプロセスにアタッチします
• gdbserver_list_sessions - アクティブなセッションをすべて一覧表示します
• gdbserver_stop - デバッグセッションを停止します

ブレークポイント制御

• gdbserver_set_breakpoint - 指定した位置にブレークポイントを設定します
• gdbserver_delete_breakpoint - ブレークポイントを削除します

実行制御

• gdbserver_continue - 実行を続行します
• gdbserver_step - 1 命令分ステップ実行します（関数内に入ります）
• gdbserver_next - 1 命令を実行します（関数内に入りません）
• gdbserver_interrupt - 実行を中断します

検査

• gdbserver_stack_frames - コールスタックのフレームを取得します
• gdbserver_local_variables - ローカル変数を取得します
• gdbserver_list_threads - スレッドをすべて一覧表示します
• gdbserver_select_thread - スレッドを切り替えます
• gdbserver_read_register - CPU レジスターを読み取ります
• gdbserver_read_memory - メモリの内容を読み取ります
• gdbserver_evaluate - 式を評価します
• gdbserver_load_symbols - シンボルファイルを読み込みます

MCP の設定

MCP 設定に追加します。

{
  "mcpServers": {
    "mcp-gdbserver": {
      "command": "mcp-gdbserver",
      "env": {}
    }
  }
}

開発

git clone https://github.com/daedalus/mcp-gdbserver.git
cd mcp-gdbserver
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

mcp-name: io.github.daedalus/mcp-gdbserver