Airbrake MCP Server

🚀 Airbrake MCP Server

Airbrake用のModel Context Protocol (MCP)サーバーです。これを使用すると、MCPクライアントから直接エラーをクエリし、デプロイを管理し、プロジェクトの統計情報を取得できます。

🚀 クイックスタート

Airbrake MCPサーバーを使うことで、エラーの管理やプロジェクトの統計情報の取得が容易になります。以下に必要な要件、インストール方法、設定方法を説明します。

✨ 主な機能

• エラーのクエリや管理が可能
• デプロイの管理が可能
• プロジェクトの統計情報を取得できる

📦 インストール

以下のコマンドを実行してインストールします。

npm install
npm run build

📚 ドキュメント

必要要件

• Node.js 18以上 (推奨: 20以上)
• 読み取り/書き込み権限を持つAirbrake APIキー
• AirbrakeプロジェクトID

設定

以下の環境変数を設定します。

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. プロジェクトURLにプロジェクトIDが表示されます。

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/