airbrake-mcp-server

🚀 Airbrake MCP 服务器

Airbrake 的模型上下文协议（MCP）服务器。它允许你直接从 MCP 客户端查询错误、管理部署并获取项目统计信息。

🚀 快速开始

要求

• Node.js 18+（推荐 20+）
• 具有读写权限的 Airbrake API 密钥
• Airbrake 项目 ID

安装

npm install
npm run build

配置

设置以下环境变量：

export AIRBRAKE_API_KEY="your_api_key"
export AIRBRAKE_PROJECT_ID="your_project_id"
export AIRBRAKE_HOST="https://api.airbrake.io"  # 可选

从哪里获取凭证

1. 在 Airbrake 中打开你的项目
2. 转到设置 → API 密钥
3. 创建一个具有读写权限的新 API 密钥
4. 你的项目 ID 位于项目 URL 中

在 Cursor 中配置

编辑你的全局 MCP 配置： /Users/<your-username>/.cursor/mcp.json

示例：

{
  "mcpServers": {
    "airbrake": {
      "command": "/absolute/path/to/node", // 哪个 node
      "args": ["/absolute/path/to/airbrake-mcp-server/dist/index.js"],
      "env": {
        "AIRBRAKE_API_KEY": "your_api_key",
        "AIRBRAKE_PROJECT_ID": "your_project_id"
      }
    }
  }
}

注意事项

⚠️ 重要提示

• 对 command 和 args 使用绝对路径。相对路径可能会失败，因为 MCP 是从不同的工作目录启动的。
• 如果你使用版本管理器（mise、nvm、asdf），将 command 指向 which node 显示的实际 Node 二进制文件。
• 如果你想在启动期间查看日志，请在 env 中设置 AIRBRAKE_MCP_DEBUG=1。

✨ 主要特性

工具（可用命令）

错误查询

• list_errors：列出最近的错误（支持分页）
• get_error_details：获取特定错误组的完整详细信息
• get_error_notices：获取错误组的所有发生情况（通知）
• get_notice_details：获取单个通知的完整详细信息

搜索与过滤

• search_errors：在错误中进行文本搜索
• filter_errors_by_status：按 open、resolved 或 ignored 进行过滤
• get_error_trend：获取错误随时间的发生趋势

错误管理

• resolve_error：将错误标记为已解决
• ignore_error：将错误标记为已忽略
• reopen_error：重新打开已解决/已忽略的错误

部署

• list_deploys：列出最近的部署
• create_deploy：创建部署通知

统计信息

• get_project_stats：获取项目健康状况和统计信息

💻 使用示例

这些示例取决于你的 MCP 客户端，但典型的提示如下：

List the last 20 Airbrake errors
Get details for error 123456
Search errors for "NoMethodError"
Resolve error 123456

📦 开发

npm run watch
npm run dev

📚 详细文档

• Airbrake API 文档：https://airbrake.io/docs/api/
• MCP：https://modelcontextprotocol.io/