Skip to main content
Glama
Honeybadger MCP Server

Honeybadger MCP Server

by vishalzambre

Honeybadger MCP サーバー セットアップ ガイド

この MCP サーバーは、Honeybadger エラー追跡を Cursor IDE と統合し、開発環境から直接エラーを取得して分析できるようにします。

前提条件

  • Node.js 18以上がインストールされている

  • APIアクセス可能なHoneybadgerアカウント

  • MCP をサポートするカーソル IDE

Related MCP server: Jira Context MCP Server

インストール

1. MCPサーバーのクローンを作成する

git clone git@github.com:vishalzambre/honeybadger-mcp.git
cd honeybadger-mcp
npm install

2. プロジェクトをビルドする

npm run build

3. NPMパッケージとして使用する(推奨)

グローバルインストール:

npm install -g honeybadger-mcp

次に、カーソルで設定します。

{
  "mcpServers": {
    "honeybadger": {
      "command": "honeybadger-mcp",
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

プロジェクトベースのインストール(代替):

MCP サーバーをプロジェクトの依存関係として管理する場合:

npm install honeybadger-mcp

この場合、カーソルmcp_servers.json内のコマンドは、プロジェクトのnode_modules内のローカル インストールを指します。

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["./node_modules/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

4. 環境変数を設定する

プロジェクト ルートに.envファイルを作成します。

# Required: Your Honeybadger API key
HONEYBADGER_API_KEY=your_api_key_here

# Optional: Default project ID (can be overridden per request)
HONEYBADGER_PROJECT_ID=your_project_id

# Optional: Custom Honeybadger URL (defaults to https://app.honeybadger.io)
HONEYBADGER_BASE_URL=https://app.honeybadger.io

4. Honeybadgerの資格を取得する

  1. APIキー:

  2. プロジェクトID :

    • Honeybadgerのプロジェクトへ移動

    • プロジェクト ID は URL にあります: https://app.honeybadger.io/projects/{PROJECT_ID}

    • またはプロジェクト設定で見つける

カーソルの設定

1. カーソルでMCPを設定する

MCPサーバーをCursorの設定に追加します。 ~/.cursor/mcp_servers.json (または同等のファイル)を編集します。

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["/path/to/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

2. 代替案: グローバルインストール

このセクションは、上記の説明に従って更新または削除されます。ローカルパスからクローンしてグローバルにインストールする従来の方法をご希望の場合は、引き続きご利用いただけますが、更新と管理を容易にするために、公開されているnpmパッケージの使用をお勧めします。

ローカルクローンからインストールする場合:

# Navigate to your cloned honeybadger-mcp directory
npm install -g . # Installs from the current directory

# Then configure in Cursor as before
# ... (Cursor configuration for local global install)

使用法

設定が完了すると、Cursor で次のツールを使用できるようになります。

1. 最近の障害の一覧

List recent unresolved errors from Honeybadger in production environment

2. 具体的な障害の詳細を取得する

Get details for Honeybadger fault ID 12345

3. 問題を分析する

Analyze Honeybadger issue 12345 and provide fix suggestions

4. エラー発生回数を取得する

Get the latest 5 occurrences for Honeybadger fault 12345

利用可能なツール

list_honeybadger_faults

オプションで環境および解決ステータス別にフィルタリングして最近の障害を一覧表示します。

パラメータ:

  • project_id (オプション): プロジェクトID

  • limit (オプション):障害の数(デフォルト:20、最大:100)

  • environment (オプション): 環境でフィルタリング

  • resolved (オプション): 解決済みのステータスでフィルタリング

get_honeybadger_fault

特定の障害に関する詳細情報を取得します。

パラメータ:

  • fault_id (必須): 障害ID

  • project_id (オプション): プロジェクトID

get_honeybadger_notices

特定の障害に関する通知(エラー発生)を取得します。

パラメータ:

  • fault_id (必須): 障害ID

  • project_id (オプション): プロジェクトID

  • limit (オプション):通知の数(デフォルト:10、最大:100)

analyze_honeybadger_issue

包括的な分析と修正提案を提供します。

パラメータ:

  • fault_id (必須): 障害ID

  • project_id (オプション): プロジェクトID

  • include_context (オプション): リクエストコンテキストを含める (デフォルト: true)

ワークフローの例

  1. 最近のエラーを一覧表示する: 「本番環境からの最新の未解決エラーを表示します」

  2. 特定のエラーを分析する: 「Honeybadger 障害 12345 を分析し、修正を提案する」

  3. エラー コンテキストを取得: 「障害 12345 の最新の発生を完全なコンテキストで取得する」

  4. レビューと修正: 分析を使用してコードの問題を理解し、修正します

トラブルシューティング

よくある問題

  1. 認証エラー: APIキーが正しく、適切な権限があることを確認してください

  2. プロジェクトが見つかりません: プロジェクトIDが正しいことを確認してください

  3. 接続の問題: Honeybadger API へのネットワーク アクセスを確認してください

デバッグモード

エラー メッセージを表示するには、サーバーを直接実行します。

node dist/index.js

ログ

MCP 関連の問題については、カーソル ログを確認してください。

  • macOS: ~/Library/Logs/Cursor/

  • Windows: %APPDATA%\Cursor\logs\

  • Linux: ~/.config/Cursor/logs/

セキュリティノート

  • APIキーを安全に保存し、バージョン管理にコミットしないでください

  • 可能な場合は環境固有の API キーを使用する

  • この統合には読み取り専用APIトークンの使用を検討してください

  • APIキーを定期的にローテーションする

貢献

この MCP サーバーを拡張するには:

  1. setupToolHandlers()メソッドに新しいツールを追加する

  2. 対応するハンドラメソッドを実装する

  3. ツールリストとドキュメントを更新する

  4. Honeybadgerの設定で徹底的にテストする

サポート

以下の問題については:

  • このMCPサーバー: コードと構成を確認してください

  • Honeybadger API : Honeybadger APIドキュメントを参照してください

  • カーソルMCP統合: カーソルのドキュメントを確認してください

Available Tools

4 tools
analyze_honeybadger_issueB

Comprehensive analysis of a Honeybadger issue with fix suggestions

Inputs: fault_id (required), project_id, include_context.

get_honeybadger_faultB

Fetch a specific fault/error from Honeybadger by ID

Inputs: fault_id (required), project_id.

get_honeybadger_noticesB

Fetch notices (occurrences) for a specific fault

Inputs: fault_id (required), project_id, limit.

list_honeybadger_faultsC

List recent faults from Honeybadger

Inputs: project_id, limit, environment, resolved.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: analyze_honeybadger_issue provides analysis and fix suggestions, get_honeybadger_fault retrieves a specific fault by ID, get_honeybadger_notices fetches occurrences for a fault, and list_honeybadger_faults lists recent faults. The descriptions make it easy to distinguish between analyzing, fetching specific items, fetching related data, and listing collections.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case: analyze_honeybadger_issue, get_honeybadger_fault, get_honeybadger_notices, and list_honeybadger_faults. The naming is predictable and readable, using clear verbs like 'analyze', 'get', and 'list' paired with specific nouns.

    Tool Count4/5

    With 4 tools, the count is reasonable for a Honeybadger server, covering core operations like listing, fetching, and analyzing faults. It's slightly on the minimal side but well-scoped for basic error monitoring tasks, though additional tools for actions like creating or updating issues might be expected in a more comprehensive set.

    Completeness4/5

    The tool set covers key read operations for Honeybadger: listing faults, fetching specific faults and their notices, and analyzing issues. However, it lacks write operations (e.g., creating, updating, or resolving faults) and broader management features, which are minor gaps that agents might need to work around for full lifecycle coverage.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Integrates GlitchTip error monitoring with AI assistants to fetch, analyze, and debug production errors. It enables users to list issues, retrieve event details, and perform guided triage of application errors through natural language.
      2
      259 npm
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with the Honeybadger error monitoring service to list, filter, and analyze fault data. It provides tools for fetching error lists and retrieving detailed fault information from Honeybadger projects.
      1
      MIT