C++调试器

基于MCP协议的C++调试器,为AI大模型提供调试C++程序的能力。

  • by cleardl
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 cleardl/mcp-cpp-debugger

使用说明

MCP Debugger

基于MCP协议的C++调试器,为AI大模型提供调试C++程序的能力。

快速开始

1. 安装依赖

安装 uv 包管理器:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装项目依赖:

uv sync
uv tool install mcp-cpp-debugger@latest

3. 配置MCP客户端

在MCP客户端(Claude CLI / Cursor / VS Code Copilot / Visual Studio)中添加配置。

支持两种传输方式:

方式一:stdio(推荐)

客户端自动启动和管理调试器进程,通过标准输入输出通信。

配置示例:

{
  "mcpServers": {
    "mcp-cpp-debugger": {
      "command": "uvx mcp-cpp-debugger",
      "args": ["--transport", "stdio"]
    }
  }
}

优点:

  • ✅ 自动管理进程生命周期
  • ✅ 无需手动启动服务器
  • ✅ 无端口冲突问题

方式二:streamable-http

手动启动服务器进程,客户端通过 HTTP 连接。

第一步:启动服务器

uvx mcp-cpp-debugger --transport http --port 8999
# 或使用简写
uvx mcp-cpp-debugger -p 8999

第二步:配置客户端

{
  "mcpServers": {
    "mcp-cpp-debugger": {
      "url": "http://localhost:8999/mcp"
    }
  }
}

优点:

  • ✅ 可查看服务器日志
  • ✅ 适合开发调试
  • ✅ 支持多客户端连接

注意: 默认端口为 8999,可通过 --port 或 -p 参数修改。

4. 开始调试

在对话中直接向AI描述调试需求,AI将自动调用调试器完成操作。