Go Delve Debugger MCP Server

Go Delve 调试器 MCP 服务

一个允许大模型与 Delve Go 调试器交互的 MCP 服务。

描述

本项目实现了一个 Model Context Protocol (MCP) 服务，并将其与 Delve Go debugger 集成，使 AI 助手能够调试 Go 应用程序。该服务提供一组工具，允许大模型启动、控制和交互调试会话。

你可以在 EXAMPLE.md 中找到一个可运行的示例。

功能

• 启动 Go 程序的调试会话
• 在代码中设置断点
• 单步执行代码（下一步、步入、步出）
• 在调试会话上下文中求值表达式
• 检查变量和堆栈跟踪
• 管理多个调试会话

安装

前置条件

• Go 1.21 或更高版本
• 已安装 Delve 调试器（go install github.com/go-delve/delve/cmd/dlv@latest）

安装

go install github.com/xhd2015/dlv-mcp/cmd/dlv-mcp@latest

使用方法

启动 MCP 服务：

dlv-mcp --listen :9097

然后在 Cursor 或任何 MCP 客户端中，将 MCP 服务配置为 http://localhost:9097/sse。

检查 MCP 服务

bunx @modelcontextprotocol/inspector dlv-mcp

可用工具

调试会话管理

• start_debug：启动新的调试会话

  • program：要调试的 Go 程序路径
  • args：程序的命令行参数（可选）
  • mode：调试模式（debug、test 或 exec，默认值：debug）

• terminate_debug：终止调试会话

  • session_id：要终止的调试会话 ID

• list_debug_sessions：列出活动的调试会话

断点管理

• set_breakpoint：在调试会话中设置断点
  • session_id：调试会话 ID
  • file：要设置断点的源文件（绝对路径）
  • line：要设置断点的行号

执行控制

• continue：继续执行调试会话

  • session_id：调试会话 ID

• next：在调试会话中跳过当前行

  • session_id：调试会话 ID

• step_in：在调试会话中步入函数

  • session_id：调试会话 ID

• step_out：在调试会话中步出函数

  • session_id：调试会话 ID

检查

• evaluate：在调试会话中求值表达式
  • session_id：调试会话 ID
  • expression：要进行求值的表达式
  • frame_id：堆栈帧 ID（可选，默认值：0）

示例工作流

1. 启动调试会话：

   start_debug program=/path/to/program.go
   

2. 设置断点：

   set_breakpoint session_id=session-123456 file=/path/to/program.go line=15
   

3. 继续执行至断点：

   continue session_id=session-123456
   

4. 求值表达式：

   evaluate session_id=session-123456 expression="myVariable"
   

5. 跳过一行：

   next session_id=session-123456
   

6. 终止会话：

   terminate_debug session_id=session-123456
   

架构

该服务由以下组件构建：

• MCP 服务层：使用 mark3labs/mcp-go 实现 Model Context Protocol
• DAP 客户端层：与 Delve 的 DAP 服务通信
• 会话管理：维护和管理调试会话

检查 MCP 服务

bunx @modelcontextprotocol/inspector go run ./cmd/dlv-mcp

使用演示客户端

我们创建了一个演示客户端，展示如何通过编程方式使用 debugger-mcp 服务。该演示将：

1. 启动 MCP 服务
2. 为 ./testdata/hello.go 启动调试会话
3. 尝试设置断点并执行调试命令
4. 正确终止会话和服务

运行演示：

go run ./demo/main.go

演示客户端展示了如何：

• 使用 JSON-RPC 启动 MCP 服务并与之通信
• 使用正确的格式发送工具调用
• 解析和处理响应
• 妥善处理错误

有关实现的更多详情，请查看 demo/main.go 和 demo/README.md。

许可证

MIT License