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/