MCP Dap

MCP开发工具

提供方 angalato08

开发工具 stdio · 本地进程 Token 社区 / 第三方 ClaudeCursorVS Code
查看接入方式

mcp-dap是一个高性能的MCP服务器,通过调试适配器协议(DAP)将AI代理连接到多种编程语言的调试会话中。

一句话选型结论

按资料字段整理

MCP Dap 属于开发工具类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude、Cursor、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 13 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量13暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

调试工具Rust本地部署AI编程辅助多语言支持开发工具

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install debugpy

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 13 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 13 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Dap当前 13 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方angalato08上游标注的维护方 angalato08
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.4 KB
来自项目仓库与上游目录的原文,未做删改

mcp-dap

一种MCP服务器,通过调试适配器协议(DAP)将AI代理连接到调试适配器。

概述

mcp-dap 是一个用Rust编写的高性能、单二进制MCP(模型上下文协议)服务器。它允许AI编码代理(如Claude、Cursor或Gemini)跨多种编程语言本地启动、控制和检查调试会话。它没有重新发明调试,而是将MCP工具调用转换为标准DAP请求,利用经过实战测试的调试适配器。

支持的调试适配器

适配器 语言
CodeLLDB Rust、C、C++
debugpy Python
深入 去

可以通过启用其他适配器 allowed_adapters 配置选项。

特性

  • 单静态二进制 --没有Node.js,没有Python运行时,没有 npm install 这是服务器本身所必需的。
  • LLM上下文保护 --自动截断大型变量值、数组和深度嵌套对象,以保护代理的上下文窗口。提供分页标记,用于按需检索其他数据。
  • 自动上下文注入 --当被调试对象在断点处停止时,服务器读取周围的源代码行并将其包含在响应中,从而消除了额外的往返。
  • 完整会话生命周期 --启动程序、附加到正在运行的进程、设置/删除断点、遍历代码、计算表达式、检查线程和调用堆栈,以及干净地断开连接。
  • 异步和并发 --基于Tokio构建的调试器在不阻塞代理交互循环的情况下处理异步调试器事件。
  • 适配器允许列表 --限制可以生成哪些调试适配器可执行文件,提供安全边界。

安装

快速安装(macOS/Linux)```bash

curl -fsSL https://raw.githubusercontent.com/angalato08/mcp-dap/main/install.sh | sh


要安装特定版本或安装到自定义目录,请执行以下操作:```bash
VERSION=0.2.0 INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/angalato08/mcp-dap/main/install.sh | sh

预构建二进制文件

从以下网址下载适用于您平台的二进制文件 GitHub 发布 页面。

来源```bash

git clone https://github.com/angalato08/mcp-dap.git
cd mcp-dap
cargo install --path .


## 配置

`mcp-dap` 接受配置作为JSON对象。所有字段都有合理的默认值,可以省略。```json
{
"max_variable_length": 1000,
"source_context_lines": 5,
"dap_timeout_secs": 30,
"max_array_items": 10,
"max_object_keys": 10,
"max_nesting_depth": 3,
"pagination_cache_max_entries": 50,
"pagination_cache_ttl_secs": 300,
"auto_context_max_scopes": 3,
"auto_context_max_vars_per_scope": 20,
"allowed_adapters": ["codelldb", "debugpy", "dlv", "python", "python3", "node", "lldb-dap"],
"github_repo": "angalato08/mcp-dap",
"github_allowed_labels": ["bug", "enhancement", "question"]
}
字段 默认值 描述
max_variable_length 1000 截断前变量值的最大字符长度
source_context_lines 5 断点点击上方和下方显示的源代码行数
dap_timeout_secs 30 DAP请求超时(秒)
max_array_items 10 分页截断前显示的最大数组元素数
max_object_keys 10 分页截断前显示的最大对象键数
max_nesting_depth 3 可变膨胀的最大嵌套深度
pagination_cache_max_entries 50 缓存分页条目的最大数量
pagination_cache_ttl_secs 300 分页缓存条目的生存时间(秒)
auto_context_max_scopes 3 自动上下文本地变量可扩展的最大范围(0禁用)
auto_context_max_vars_per_scope 20 自动上下文输出中每个作用域的最大顶级变量
allowed_adapters 请参见上文 允许的调试适配器基名。空列表禁用允许列表
github_repo "angalato08/mcp-dap" GitHub存储库位于 owner/repo 格式为 debug_create_issue.空字符串禁用该工具
github_allowed_labels ["bug", "enhancement", "question"] 允许的问题标签。空列表允许任何标签

用法

mcp-dap 使用MCP协议通过stdio进行通信。在AI代理或IDE中将其配置为MCP服务器。

克劳德桌面/克劳德代码```json

{
"mcpServers": {
"mcp-dap": {
"command": "mcp-dap",
"args": []
}
}
}


### 光标```json
{
"mcpServers": {
"mcp-dap": {
"command": "mcp-dap",
"args": []
}
}
}

可用的MCP工具

工具 说明
debug_launch 通过在调试适配器下启动程序来启动调试会话
debug_attach 通过PID附加到已运行的进程
debug_set_breakpoint 使用可选条件在文件和行处设置断点
debug_remove_breakpoint 删除文件和行上的断点
debug_continue 继续执行,直到下一个断点或进程退出
debug_step 介入、退出或越过当前线路
debug_get_stack 获取当前调用堆栈及其周围的源代码上下文
debug_evaluate 在当前调试帧中计算表达式或读取变量
debug_pause 暂停执行一个或所有线程
debug_threads 列出被调试对象中的所有线程
debug_get_page 使用分页标记获取截断调试结果的下一页
debug_disconnect 结束调试会话,终止被调试对象,并清理
debug_create_issue 针对配置的仓库提交GitHub问题(错误报告、功能请求或问题)

快速启动工作流

必须按此顺序调用工具——每个步骤都需要前一个步骤:```
debug_launch ──► debug_set_breakpoint ──► debug_continue ──► inspect ──► debug_disconnect
▲ │
│ ▼
◄── debug_step ◄─┘


1. **`debug_launch`** (或 `debug_attach`)--启动调试会话
1. **`debug_set_breakpoint`** --在文件行位置设置断点
1. **`debug_continue`** --运行,直到断点命中或程序退出
1. **检查停止状态:**
- `debug_get_stack` --使用源上下文查看调用堆栈
- `debug_evaluate` --计算表达式或读取变量
- `debug_threads` --列出所有线程
1. **`debug_step`** --介入/退出/重新介入,然后再次检查
1. **`debug_continue`** --继续到下一个断点(重复3-5)
1. **`debug_disconnect`** --结束会议并清理

> 一次只能有一个调试会话处于活动状态。呼叫 `debug_disconnect` 在开始新的之前。

## 示例会话

调试一个在除以零时死机的Rust程序:```jsonc
// 1. Launch the program under CodeLLDB
debug_launch({
"adapter_path": "codelldb",
"program": "./target/debug/myapp",
"program_args": ["--input", "data.csv"]
})
// → "Session started (CodeLLDB, pid 48291)"

// 2. Set a breakpoint
debug_set_breakpoint({
"file": "/home/user/myapp/src/main.rs",
"line": 42
})
// → "Breakpoint set at src/main.rs:42"

// 3. Run to the breakpoint
debug_continue({})
// → Stopped at src/main.rs:42 — shows source context + local variables

// 4. Inspect a variable
debug_evaluate({ "expression": "divisor" })
// → "divisor = 0 (i32)"

// 5. Step over to the next line
debug_step({ "granularity": "over" })
// → Stopped at src/main.rs:43 — shows updated source context

// 6. Evaluate an expression
debug_evaluate({ "expression": "dividend / (divisor + 1)" })
// → "42 (i32)"

// 7. Clean up
debug_disconnect({})
// → "Session disconnected"

调试适配器设置

mcp-dap要求每种语言都有一个调试适配器。安装所需的适配器:

CodeLLDB(Rust、C、C++)

CodeLLDB作为VS Code扩展分发。要提取独立适配器二进制文件:```bash

Download the latest release for your platform

From: https://github.com/nickovs/codelldb-standalone/releases

Or extract from the VS Code extension:

code --install-extension vadimcn.vscode-codelldb

The adapter binary is at:

~/.vscode/extensions/vadimcn.vscode-codelldb-*/adapter/codelldb


将适配器添加到您的 `PATH`,或在中使用完整路径 `adapter_path`.

### debugpy(Python)```bash
pip install debugpy

适配器被调用为 python -m debugpy.adapter.在你的 debug_launch 呼叫:```jsonc
debug_launch({
"adapter_path": "python",
"adapter_args": ["-m", "debugpy.adapter"],
"program": "my_script.py"
})


### 深入(Go)```bash
go install github.com/go-delve/delve/cmd/dlv@latest

Delve使用TCP传输——适配器监听端口,mcp-dap连接到端口:```jsonc
debug_launch({
"adapter_path": "dlv",
"adapter_args": ["dap", "--listen", "127.0.0.1:12345"],
"transport": {"tcp": 12345},
"program": "./cmd/myapp"
})


## 高级用法

### TCP传输

一些适配器(如Delve)通过TCP而不是stdio进行通信。使用 `transport` 参数:```jsonc
debug_launch({
"adapter_path": "dlv",
"adapter_args": ["dap", "--listen", "127.0.0.1:12345"],
"transport": {"tcp": 12345},
"program": "./main.go"
})

适配器启动,在指定端口上侦听,mcp-dap作为TCP客户端连接到它。

附加到正在运行的进程

使用 debug_attach 通过PID连接到已运行的进程:```jsonc
debug_attach({
"adapter_path": "codelldb",
"pid": 12345
})


这对于调试长时间运行的服务器或难以从冷启动中复制的进程非常有用。适配器必须支持DAP `attach` 请求(CodeLLDB和debugpy-do;Delve使用不同的连接流)。

### 额外的启动参数

使用 `extra_launch_args` 传递合并到DAP启动请求中的适配器特定配置:```jsonc
debug_launch({
"adapter_path": "codelldb",
"program": "./target/debug/myapp",
"extra_launch_args": {
"env": {"RUST_LOG": "debug"},
"sourceMap": {"/build": "/src"},
"initCommands": ["settings set target.x86-disassembly-flavor intel"]
}
})

确切的键取决于调试适配器——有关支持的选项,请参阅其文档。

故障排除

错误 原因 修复
Adapter "foo" is not in the allowed list 适配器基名不在 allowed_adapters 将其添加到 allowed_adapters 配置数组,或清除数组以禁用允许列表
Timed out after N seconds waiting for DAP response 程序在遇到断点之前退出,或者断点位于未执行的行上 验证断点是否位于可执行行上;增加 dap_timeout_secs 如果程序需要更多时间才能到达
No active debug session 在没有活动会话的情况下调用inspect/sttep/continue工具 调用 debug_launch 或 debug_attach 首先
A debug session is already active 呼叫 debug_launch/debug_attach 会话运行时 呼叫 debug_disconnect 先结束当前会话
Failed to spawn adapter process 找不到适配器二进制文件或无法执行 请验证适配器是否已安装,以及您的 PATH,或在中使用绝对路径 adapter_path
Pagination token not found / expired 使用过时或无效的分页标记 debug_get_page 重新运行原始文件 debug_evaluate 致电获取新代币;令牌过期时间 pagination_cache_ttl_secs (默认300秒)

建筑```

[ AI Agent (Claude / Cursor / Gemini) ]
|
v MCP Protocol (stdio)
|
+------------------------------+
| mcp-dap |
| |
| +------------------------+ |
| | MCP Tool Handlers | |
| +-----------+------------+ |
| | |
| +------------------------+ |
| | Context Optimizer (LLM)| | <- Truncation, source injection
| +-----------+------------+ |
| | |
| +------------------------+ |
| | DAP State Machine | |
| +-----------+------------+ |
+--------------+---------------+
|
v DAP Protocol (stdio)
|
+---------+---------+
| Debug Adapter | (CodeLLDB, debugpy, delve)
+---------+---------+
|
v
[ Target Process ]
```

许可证

该项目根据 MIT许可证.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Dap 怎么安装?

在客户端按下面的安装命令接入:pip install debugpy。装完在客户端配置里引用同一个包或端点。

MCP Dap 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Dap 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Dap 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

MCP Dap 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Dap 能提供哪些能力?

资料显示约 13 个工具;能力标签包括 调试工具、开发工具、Rust、Claude、AI编程辅助。具体工具清单以官方文档为准。

MCP Dap 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

MCP Dap 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。