Airbrake MCP

空气制动MCP服务器

空气制动器的模型上下文协议（MCP）服务器。它允许您直接从MCP客户端查询错误、管理部署和获取项目统计数据。

需求

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

安装

npm install
npm run build

VS代码MCP

此仓库现在包括作为VS Code MCP服务器运行和发布到MCP注册表所需的部分：

• .vscode/mcp.json 用于直接工作区安装
• server.json 用于MCP注册表出版物
• mcpName 在 package.json 用于npm所有权验证

VS Code快速入门

1. 在VS Code中打开此文件夹。
2. 跑 MCP: Open Workspace Folder Configuration 或 MCP: List Servers.
3. 承诺 .vscode/mcp.json 指向 npx -y airbrake-mcp-server.
4. 当VS代码提示输入Airbrake API密钥和项目ID时。

从MCP库安装

一旦包发布到npm并在MCP注册表中注册，就可以通过搜索以下内容从VS Code MCP库安装它 @mcp airbrake.

自动发布

此仓库包括GitHub Actions工作流，位于 .github/workflows/publish-mcp-registry.yml 它在版本标签上发布到MCP注册表，如 v1.0.0 使用GitHub OIDC。

配置

设置以下环境变量：

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

在哪里获取凭证

1. 在Airbrake中打开您的项目
2. 前往设置→ API密钥
3. 创建具有读/写权限的新API密钥
4. 您的项目ID位于项目URL中

在游标中配置

编辑您的全局MCP配置：

/Users//.cursor/mcp.json

例子：

{
  "mcpServers": {
    "airbrake": {
      "command": "/absolute/path/to/node", // which 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.
• 如果你想在启动过程中记录日志，请设置 AIRBRAKE_MCP_DEBUG=1 在 env.
• 如果您使用此存储库中的工作区配置，VS Code将提示您输入空气制动器凭据，而不是要求您手动编辑文件。

工具（可用命令）

错误查询

• 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

资源

• 空气制动器API文件：https://airbrake.io/docs/api/
• MCP：https://modelcontextprotocol.io/