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.

概覽

AI 產生的概覽

讓編碼代理列出、認領並檢視 owl24 的正式環境錯誤群組,並在修復後標記為已解決。

功能
把支援 MCP 的編碼代理連接到 owl24 專案的錯誤資料。工具包括 list_errors(去重後的錯誤群組)、queue_error 與 list_queue(代理存取佇列)、claim_error(認領項目)、get_trace(span、日誌與堆疊追蹤)、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 基礎網址。僅支援桌面用戶端。
安裝前請注意
claim_error 在項目首次被認領時計費一次,且沒有每月上限;若改為釋放項目或認領過期,費用不退,但再次認領同一項目不會重複計費。列出、排入佇列、解決與釋放皆免費。此伺服器會寫入佇列狀態與解決備註,並將專案錯誤資料傳送到 owl24 API。請妥善保管 OWL24_API_KEY;合併請求仍由人工審查。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Owl24 Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

ToolDoes
list_errorsDeduplicated error groups — occurrence counts, first/last seen, queue state, whether an AI report already exists
queue_errorAdds an error group to the agent-access queue (free, never calls AI)
list_queueLists queue items — defaults to open/unclaimed
claim_errorClaims a queue item so nothing else works it at the same time — this is what's billed, once (see below)
get_traceThe actual evidence — spans, logs, stack trace for one trace
get_rca_reportChecks for an existing cached AI root-cause report (read-only)
resolve_errorMarks a queue item resolved, with a note naming the PR and fingerprint — free, doesn't trigger any charge
count_open_itemsCheap poll target — just the open-item count, no full list fetch
release_errorGives up on a claimed item without resolving it — doesn't add a new charge (a claim's charge, if any, already happened)
extend_claimPushes a claim's expiry out if you're still actively working it

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

bash
claude mcp add owl24 -e OWL24_API_KEY=your_api_key -- npx -y owl24-mcp

Cursor

Add to your MCP settings (Cursor Settings → MCP):

json
{  "mcpServers": {    "owl24": {      "command": "npx",      "args": ["-y", "owl24-mcp"],      "env": {        "OWL24_API_KEY": "your_api_key"      }    }  }}

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

VariableRequiredDefault
OWL24_API_KEYYes—
OWL24_API_BASENohttps://api.owl24.dev — override for self-hosted/local testing

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
  1. v0.2.2最新Oct 3, 2026