devtap MCP

MCPAI代理

提供方 tma1-ai

AI代理 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

devtap 是一个自动化工具,用于捕获构建和开发命令的输出,并通过 MCP(模型上下文协议)将其反馈到 AI 编程工具会话中,支持多代理并行分析。

一句话选型结论

按资料字段整理

devtap MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

自动化开发Go本地部署AI编程辅助构建工具集成多代理协作错误分析

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
docker run -d \

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
devtap MCP当前 5 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

devtap

自动将构建/开发过程输出连接到AI编码会话。

devtap 从构建和开发命令中捕获stdout/stderr,然后通过以下方式将其馈送到AI编码工具会话中 主控程序 (模型上下文协议)。它还可以将相同的输出扇出到多个编码代理。每个代理都会消耗自己的副本,这样并行会话就不会干扰。

问题

在vibe编码工作流程中,您可以在一个终端中运行AI编码工具,并在另一个终端上构建命令。当出现错误时,您可以手动将粘贴日志复制到编码会话中。 devtap 自动执行此反馈循环。

三种常见的情况使这种情况特别痛苦:

  1. 您需要关注并快速修复的多个本地开发进程(前端+后端+工作进程)。
  2. 多个编码代理在同一个项目上工作,您希望他们并行分析相同的失败并比较结果。
  3. 在远程机器(CI、dev box)上进行构建/测试运行,您需要将其输出反馈给本地编码代理。

快速开始

安装```bash

go install github.com/killme2008/devtap/cmd/devtap@latest


或者通过Homebrew安装:```bash
brew install killme2008/tap/devtap

或从以下网址下载 GitHub发布.

设置```bash

cd /path/to/your-project
devtap install --adapter claude-code


这配置了MCP服务器,并将devtap指令注入到项目的指令文件中(例如。, `CLAUDE.md`).看 支持的工具 适用于所有可用的适配器。

### 技能(可选)

devtap附带了一个内置 技能 当MCP不可用时,它作为CLI回退。安装它以让代理按需获取构建输出:```bash
# Claude Code
mkdir -p ~/.claude/skills && cp -r skills/devtap-get-build-errors ~/.claude/skills/

# Codex CLI
mkdir -p ~/.codex/skills && cp -r skills/devtap-get-build-errors ~/.codex/skills/

或者直接从仓库中获取,无需克隆:```bash
DEST=~/.claude/skills/devtap-get-build-errors
mkdir -p "$DEST" && cd "$DEST"
for f in SKILL.md scripts/get_build_errors.sh; do
mkdir -p "$(dirname "$f")"
curl -sL "https://raw.githubusercontent.com/killme2008/devtap/main/skills/devtap-get-build-errors/$f" -o "$f"
done
chmod +x scripts/get_build_errors.sh


### 用法

**航站楼A** --捕获构建输出:```bash
devtap -- cargo check
devtap -- go build ./...
devtap --filter-regex "error|warning" -- npm run build

# Long-running dev servers (output is flushed every 2s by default)
devtap -- npm run dev

端子B --像往常一样使用你的AI编码工具。它将自动调用 get_build_errors 通过MCP获取捕获的构建错误。

如果您想在没有MCP的情况下进行验证,请运行:```bash
devtap drain


典型输出:```text
[devtap: cargo check] Build failed (exit code 101):
...

提示: 由于devtap从任何命令中捕获stdout,因此您可以向编码代理发送任意消息:```bash
devtap -- echo "Please refactor the auth module to use JWT"


这将devtap变成了一个通用的人→代理消息通道——无需复制粘贴。

## 运作原理

**本地模式** (默认,基于文件):```
Terminal A (Claude Code)          Terminal B (build/dev)
┌──────────────────┐             ┌────────────────────────────┐
│  MCP tool call:  │   stdio     │  devtap -- cargo check     │
│  get_build_errors├─────────────┤                            │
│                  │  JSON-RPC   │  captures stdout/stderr,   │
│  receives errors,│             │  fans out to all adapters: │
│  fixes code      │             │  ~/.devtap//claude-code/│
└──────────────────┘             │  ~/.devtap//codex/      │
└────────────────────────────┘

跨机模式 (与 GreptimeDB):```
Your laptop CI / remote build server
┌──────────────────┐ ┌────────────────────────────┐
│ Claude Code │ │ devtap -- make │
│ get_build_errors│ │ │
│ │ │ captures stdout/stderr │
│ receives errors,│ └─────────────┬──────────────┘
│ fixes code │ │ write
└────────┬─────────┘ ▼
│ drain ┌────────────────────────────┐
└───────────────────►│ GreptimeDB │
│ (shared session store) │
└────────────────────────────┘


1. `devtap install` 为您的AI工具配置MCP服务器(pass `--session` 和 `--store` 用于跨机器设置)
1. `devtap -- ` 运行命令,捕获stdout/stderr,扇出所有已注册的适配器
1. 每个AI工具都通过以下方式独立地排出自己的副本 `get_build_errors`
1. AI看到错误并修复它们

当 `mcp-serve`/`drain` 以显式开头 `--session` 或 `--store`,devtap可以合并两个来源的输出:

- `local`:从默认后端自动检测项目会话
- `configured`:明确 `--session`/`--store` 目标

如果两者都解析为相同的后端+会话,devtap将使用单个源。否则,它会耗尽两者,消除相同的消息重复,并在标签前添加源信息(例如 `myhost/local |`).

## 支持的工具

|工具|适配器|集成|配置文件|指令文件|
|------|---------|-------------|-------------|------------------|
| 克劳德代码 | `claude-code` |MCP服务器| `.mcp.json` | `CLAUDE.md` |
| Codex CLI | `codex` |MCP服务器| `.codex/config.toml` | `AGENTS.md` |
| 开源代码 | `opencode` |MCP服务器| `opencode.json` | `AGENTS.md` |
| Gemini CLI | `gemini` |MCP服务器| `.gemini/settings.json` | `GEMINI.md` |
| 帮助 | `aider` | `--lint-cmd` 包装纸| `.devtap-aider-lint.sh` | `CONVENTIONS.md` |

任何与MCP兼容的工具都可以使用 `devtap mcp-serve` 直接。

## 自动循环模式(克劳德代码)

Claude Code支持一个Stop钩子,可以在错误仍然存在时阻止Claude停止:```bash
devtap install --adapter claude-code --auto-loop --max-retries 5

这将配置:

  • 用于按需错误查询的MCP服务器
  • 如果构建错误悬而未决,则停止阻止Claude完成的钩子
  • 允许停止前重试5次的安全限制

存储后端

文件(默认)

零依赖JSONL文件 ~/.devtap///pending.jsonl每个适配器都有自己的队列供独立使用。原子重命名以确保并发安全。

GreptimeDB (可选)

用于持久历史记录、基于SQL的过滤和更丰富的统计数据。使用远程GreptimeDB实例,构建和AI工具甚至不需要在同一台机器上——请参阅 跨机器构建 了解详情。

看 GreoptimeDB安装指南 更多选择。

Docker快速入门:```bash
docker run -d \
--name greptime-devtap \
--restart unless-stopped \
-p 127.0.0.1:4000-4002:4000-4002 \
-v ~/.devtap/greptimedb_data:/greptimedb_data \
greptime/greptimedb:latest standalone start \
--http-addr 0.0.0.0:4000 \
--rpc-bind-addr 0.0.0.0:4001 \
--mysql-addr 0.0.0.0:4002


容器在后台运行(`-d`)Docker自动启动(`--restart unless-stopped`).这 `-v` 旗架 `~/.devtap/greptimedb_data/` 用于持久存储。```bash
# Configure in ~/.devtap/config.toml (this becomes the default store)
cat > ~/.devtap/config.toml < [args...]

Flags:
-a, --adapter        AI tool adapter (default "claude-code")
-s, --session          Target session ("auto", "pick", or explicit name)
--store       Storage backend ("file" or "greptimedb")
--filter-regex    Regex filter for output lines
--filter-invert        Invert filter (exclude matching lines)
--max-lines         Max lines per drain (default 10000)
--tag           Log tag prefix (default: command name)
--debounce        Flush interval for captured output (default "2s", 0 to disable)

Subcommands:
install     Configure AI tool integration (--session and --store are forwarded to MCP config)
mcp-serve   Start MCP stdio server
drain       Read pending messages as plain text
-q, --quiet      Raw output without source/tag headers
status      Show pending message counts
-q, --quiet      Compact output (pending count only)
history     Query build error history (GreptimeDB only)
--since     Time range (default "24h")
--tag     Filter by tag
--limit       Max entries (default 20)
gc          Remove expired session data (default TTL: 7 days)

线路超过 --max-lines 被巧妙地截断:头部和尾部保留了省略通知。连续的重复行被合并。

devtap mcp-serve 和 devtap drain 可以如上所述聚合多个源(本地+配置)。 devtap drain --filter-sql 是单源模式,需要 --store greptimedb.

故障排除

  • 没有输出,但您需要日志:run devtap status 首先,然后 devtap drain --max-lines 200.
  • 使用意外会话:使用运行 --session pick 一次确认目标会话。
  • 多源漏极显示警告:可到达的源仍然返回;警告表示一个源不可用。
  • MCP工具未被调用:重新运行 devtap install --adapter 在项目根目录中,重新启动AI工具会话。

安全与隐私

  • 所有数据都保留在本地。 构建输出存储在您的机器上 ~/.devtap/ (文件后端)或在自托管的GreptimeDB实例中。不会向外部服务器发送任何内容。
  • MCP通信是本地标准。 MCP服务器作为AI工具的子进程运行,通过stdin/stdout JSON-RPC进行通信。没有打开网络插座。
  • 没有遥测。 devtap不收集使用数据、分析或崩溃报告。
  • --filter-sql 这不是安全边界。 它包括一个尽力而为的关键字块列表,但是为了方便而设计的,而不是为了对抗输入。用户已经具有完全的本地和数据库访问权限。
  • 清理: 跑 devtap gc 删除过期的会话数据,或删除 ~/.devtap/ 完全删除所有存储的数据。

许可证

麻省理工学院

常见问题

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

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

devtap MCP 怎么在 Claude 里配置?

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

devtap MCP 收费吗?

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

devtap MCP 需要 API Key 吗?

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

devtap MCP 支持哪些客户端?

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

devtap MCP 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 Go、Claude、多代理协作。具体工具清单以官方文档为准。

devtap MCP 需要什么运行环境?

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

devtap MCP 是本地还是远程?

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

热门专题

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

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