Pexpect MCP

🚀 pexpect-mcp

pexpect-mcp 是一個 MCP（模型上下文協議）服務器，它為調試和進程交互提供遠程 pexpect 會話控制。藉助該服務器，能夠實現對程序的交互式調試和進程交互操作。

🚀 快速開始

pexpect-mcp 服務器允許AI助手利用 pexpect 功能執行Python代碼，可與LLDB、GDB等工具進行交互式調試會話，適用於需要程序化交互的命令行工具。從某種意義上說，它更像是一個維護有狀態Python會話的服務器。

✨ 主要特性

• 提供遠程 pexpect 會話控制，支持AI助手執行帶 pexpect 功能的Python代碼。
• 可與LLDB、GDB等工具進行交互式調試會話，滿足多種調試需求。

📦 安裝指南

使用以下命令進行安裝：

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 文件。