owl24-mcp

Name: owl24-mcp
Author: Madnands5

本地服务

github.com/Madnands5开发工具04 周前更新

代码仓库

关于 owl24-mcp

owl24-mcp 是面向 Claude Code、Cursor 等编码 Agent 的 MCP 服务，可在编辑器中读取 owl24 错误并协助处理。它提供错误队列、追踪和认领流程，但不会自行启动新的 AI 根因分析。

主要功能

01列出去重后的错误组
02将错误加入处理队列
03认领并延长错误任务
04读取追踪与已有根因报告
05解决或释放队列任务

适用场景

01在编辑器中检查生产环境错误
02读取堆栈与追踪以定位问题
03修复后标记错误已解决
04放弃处理并释放认领任务

MCP 相关

该 MCP 服务向 MCP 客户端暴露 owl24 错误查询、队列管理、追踪读取及处理状态工具。它不会触发新的 AI 根因分析。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "madnands5-owl24": {
      "command": "npx",
      "args": [
        "-y",
        "owl24-mcp"
      ],
      "env": {
        "OWL24_API_KEY": "<OWL24_API_KEY>",
        "OWL24_API_BASE": "<OWL24_API_BASE>"
      }
    }
  }
}

启动命令npx -y owl24-mcp

需要配置的环境变量

OWL24_API_KEY密钥Your owl24 project API key, from that project's page on the owl24 dashboard. Agent Access must be enabled for the project first.

OWL24_API_BASEOverrides the API base URL, for local or self-hosted testing only. Production customers never need to set this.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmowl24-mcp0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	integer	否	最多返回的组数（默认值：20，最大值：100）。
search	string	否	按服务名称或操作名称进行子串匹配。
serviceName	string	否	要筛选的确切服务名称，例如 "checkout-service"。省略则查看所有服务。

详细介绍

owl24-mcp

适用于 owl24 的 MCP 服务——将生产环境错误交给你已在使用的编码 Agent（Claude Code、Cursor 或任何支持 MCP 的客户端）。它会认领问题、读取跟踪记录和堆栈跟踪，并编写修复方案，让你不必为了一个从未打开过的文件去阅读堆栈跟踪。

这并非要取代 REST-plus-AGENTS.md 工作流，而是以更精简的方式访问完全相同的端点。如果你已经有基于 AGENTS.md 的 CI 循环，就不需要它。它适用于在编辑器中与你的 Agent 交互式协作。

可以做什么

工具	功能
`list_errors`	去重后的错误组——发生次数、首次／最近出现时间、队列状态，以及是否已有 AI 报告
`queue_error`	将错误组添加到 Agent 访问队列（免费，不会调用 AI）
`list_queue`	列出队列项——默认显示未解决／未认领的项目
`claim_error`	认领队列项，避免其他人同时处理——这一步会产生费用，且仅收取一次（见下文）
`get_trace`	查看实际证据——单条跟踪记录中的跨度、日志和堆栈跟踪
`get_rca_report`	检查是否已有缓存的 AI 根因报告（只读）
`resolve_error`	将队列项标记为已解决，并附上注明 PR 和指纹的备注——免费，不会触发任何费用
`count_open_items`	低成本轮询目标——只返回未解决项目数，不获取完整列表
`release_error`	放弃已认领的项目，但不将其标记为已解决——不会产生新费用（如有认领费用，费用已在之前产生）
`extend_claim`	如果你仍在积极处理某个认领项目，则延长其过期时间

**它刻意不支持的功能：**运行新的 AI 根因分析。这是需要单独付费、由人工在 owl24 控制面板上执行的操作——此服务绝不会主动消耗 AI-RCA 额度。get_rca_report 只会读取已有报告；如果没有报告，就根据 get_trace 的数据进行调查，方式与 AGENTS.md 对 Agent 的说明相同。

**计费：**列出和加入队列始终免费。对于此前从未认领过的项目，claim_error 成功时会立即收取一笔小额费用（当前费率见 Pricing），而不是等到项目之后解决时才收费，且没有月度上限。如果你选择 release_error 而不是修复问题，或者认领只是过期，该费用不会退还；但之后再次认领同一个项目绝不会重复收费。resolve_error 本身不会产生费用——有了修复方案后再使用它；如果没有修复方案，请使用同样免费调用的 release_error，以便后续认领者看到准确的记录。

我们不构建、运行或托管你的 Agent。此服务会在你的机器上本地运行，并使用你自己的项目 API 密钥——与其所封装的 REST 工作流采用相同的信任模式。

安装

你不需要自行安装——大多数 MCP 客户端会按需通过 npx 运行它。

Claude Code

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

Cursor

添加到 MCP 设置中（Cursor Settings → MCP）：

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

其他 MCP 客户端也一样：使用相同的 command／args／env 结构，通过 stdio 运行 npx -y owl24-mcp，并在环境中设置 OWL24_API_KEY。

从项目在 owl24 控制面板上的页面获取 API 密钥。必须先通过你账户自己的 API 为该项目启用 Agent Access，否则这里的每个工具都会返回 403。

环境变量

变量	必需	默认值
`OWL24_API_KEY`	是	—
`OWL24_API_BASE`	否	`https://api.owl24.dev` — 用于可自托管／本地测试的覆盖设置

示例

连接后，在 Claude Code 或 Cursor 中：

checkout-service 中有什么问题？

模型会调用 list_errors({ serviceName: "checkout-service" })，读取结果，然后可以直接调用 get_trace 查看最严重的问题，自行编写修复方案；等你打开 PR 后，再调用带有备注的 resolve_error。PR 始终由人工审核；这里的任何操作都不会合并内容。