AI导哈

错误查询与管理服务器

Airbrake MCP Server 是一个用于查询错误、管理部署和获取项目统计信息的服务器，适用于开发团队进行错误监控和管理。

  • by Dach3r
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Dach3r/airbrake-mcp-server

使用说明

空气制动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/<your-username>/.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/

相关 MCP