Pexpect MCP

🚀 pexpect - mcp

MCP（モデルコンテキストプロトコル）サーバーで、デバッグやプロセスの相互作用のためにリモートのpexpectセッション制御を提供します。

🚀 クイックスタート

このMCPサーバーにより、AIアシスタントはpexpect機能を使ってPythonコードを実行でき、LLDBやGDBなどのツールや、プログラムによる相互作用が必要な他のコマンドラインユーティリティとの対話型デバッグセッションが可能になります。

ある意味では、これは状態を保持するPythonセッションを維持するサーバーという側面が強く、単なるpexpect MCPというよりも広い概念です。

📦 インストール

uv tool install git+https://github.com/mitsuhiko/pexpect-mcp

💻 使用例

基本的な使用法

MCPサーバーとしての使用

Claude Codeの設定に以下を追加します。

{
  "mcpServers": {
    "pexpect": {
      "command": "pexpect-mcp"
    }
  }
}

ツールの使用

サーバーは単一のツール pexpect_tool を提供します。

パラメーター:

• code (文字列): pexpectサポート付きで実行するPythonコード
• timeout (オプションの整数): タイムアウト時間（秒）（デフォルト: 30）

使用例:

# デバッグセッションを開始する
child = pexpect.spawn('lldb ./my-program')
child.expect('(lldb)')

# プログラムを実行する
child.sendline('run')
child.expect('(lldb)')
print(child.before.decode())

# バックトレースを取得する
child.sendline('bt')
child.expect('(lldb)')
print(child.before.decode())

高度な使用法

このリポジトリには、バグのあるCプログラム（demo-buggy.c）のデモが含まれており、pexpectインターフェースを通じてLLDBを使用してデバッグできます。これにより、サーバーの対話型デバッグセッションの機能が実証されます。

プログラム `./demo-buggy` は実行時にクラッシュします。LLDBを使用して以下を行います。
- デバッガーの下でプログラムを起動する
- クラッシュの場所と原因を特定する
- 変数、メモリ、コールスタックを調べる
- クラッシュの根本原因を報告する

🔧 技術詳細

要件

• Python ≥ 3.12.1
• pexpect ≥ 4.9.0
• mcp ≥ 1.13.0

📄 ライセンス

詳細については、LICENSEファイルを参照してください。