
Owl24 Mcp
io.github.Madnands5v0.2.2更新于 Oct 3, 2026
Hand a production error to the coding agent you already use — it claims it and writes the fix.
概览
让编码代理列出、认领并查看 owl24 的生产错误分组,并在修复后将其标记为已解决。
- 功能
- 把支持 MCP 的编码代理连接到 owl24 项目的错误数据。工具包括 list_errors(去重后的错误分组)、queue_error 与 list_queue(代理访问队列)、claim_error(认领条目)、get_trace(跨度、日志与堆栈跟踪)、get_rca_report(读取已有的缓存 AI 根因报告)、resolve_error 与 release_error(解决或放弃条目),以及 count_open_items 和 extend_claim。它无法发起新的 AI 根因分析,那仍是 owl24 控制台中单独的付费操作。
- 适用场景
- 适合在编辑器内与编码代理交互式协作时使用,让代理拉取生产错误、阅读跟踪并起草修复。若你已有基于 AGENTS.md 的 CI 流程,则不必安装,因为它访问的是同一批接口。
- 运行要求
- 通过 stdio 在本地运行,通常用 npx 启动,因此需要 Node.js。需要环境变量 OWL24_API_KEY,取自 owl24 控制台的项目页面,并且该项目必须先启用 Agent Access,否则所有工具都会返回 403。OWL24_API_BASE 可选,用于自托管或本地测试时覆盖 API 基础地址。仅支持桌面客户端。
安装
在 SourceWeft 中
- 打开 控制台中的 Owl24 Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
owl24-mcp
MCP server for owl24 — hand a production error to the coding agent you already use (Claude Code, Cursor, or any MCP-speaking client). It claims the item, reads the trace and stack trace, and writes the fix — instead of you reading a stack trace for a file you've never opened.
This doesn't replace the REST-plus-AGENTS.md workflow — it's a thinner way to reach the exact same endpoints. If you already have an AGENTS.md-driven CI loop working, you don't need this. This is for working with your agent interactively, from inside your editor.
What it can do
What it deliberately can't do: run a new AI Root-Cause Analysis. That's a separate, paid, human action from the owl24 dashboard — this server never spends AI-RCA credit on its own initiative. get_rca_report only reads a report that already exists; if one doesn't, investigate from get_trace's data instead, the same way AGENTS.md already tells an agent to.
Billing: listing and queuing are always free. A small charge (current rate on Pricing) applies once, the moment claim_error succeeds on an item that's never been claimed before — not when it's later resolved, and with no monthly cap. If you release_error instead of fixing it, or the claim simply expires, that charge isn't refunded, but re-claiming the same item later is never billed again. resolve_error itself never adds a charge — use it once you actually have a fix, and use release_error (also free to call) when you don't, so the record stays accurate for whoever claims it next.
We don't build, run, or host your agent. This server runs locally, on your machine, using your own project API key — same trust model as the REST workflow it wraps.
Install
You don't need to install this yourself — most MCP clients run it via npx on demand.
Claude Code
Cursor
Add to your MCP settings (Cursor Settings → MCP):
Any other MCP client: the same command/args/env shape works — npx -y owl24-mcp over stdio, with OWL24_API_KEY in the environment.
Get your API key from a project's page on the owl24 dashboard. Agent Access needs to be turned on for that project first, via your account's own API — every tool here 403s until it is.
Environment variables
Example
Once connected, in Claude Code or Cursor:
What's breaking in checkout-service?
The model calls list_errors({ serviceName: "checkout-service" }), reads the results, and can go straight into get_trace for the top offender, write the fix itself, and — once you've opened the PR — resolve_error with a note. A human always reviews the PR; nothing here merges anything.
License
MIT
来源:README.md,提交 4bf2407
工具
0版本历史
1- v0.2.2最新Oct 3, 2026


