Honeybadger MCP サーバー セットアップ ガイド
この MCP サーバーは、Honeybadger エラー追跡を Cursor IDE と統合し、開発環境から直接エラーを取得して分析できるようにします。
前提条件
- Node.js 18以上がインストールされている
- APIアクセス可能なHoneybadgerアカウント
- MCP をサポートするカーソル IDE
インストール
1. MCPサーバーのクローンを作成する
git clone git@github.com:vishalzambre/honeybadger-mcp.git
cd honeybadger-mcp
npm install
2. プロジェクトをビルドする
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の資格を取得する
- APIキー:
- プロジェクト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 (オプション): プロジェクトIDlimit （オプション）：障害の数（デフォルト：20、最大：100）environment （オプション）: 環境でフィルタリングresolved （オプション）: 解決済みのステータスでフィルタリング
get_honeybadger_fault
特定の障害に関する詳細情報を取得します。
パラメータ:
fault_id (必須): 障害IDproject_id (オプション): プロジェクトID
get_honeybadger_notices
特定の障害に関する通知（エラー発生）を取得します。
パラメータ:
fault_id (必須): 障害IDproject_id (オプション): プロジェクトIDlimit （オプション）：通知の数（デフォルト：10、最大：100）
analyze_honeybadger_issue
包括的な分析と修正提案を提供します。
パラメータ:
fault_id (必須): 障害IDproject_id (オプション): プロジェクトIDinclude_context (オプション): リクエストコンテキストを含める (デフォルト: true)
ワークフローの例
- 最近のエラーを一覧表示する: 「本番環境からの最新の未解決エラーを表示します」
- 特定のエラーを分析する: 「Honeybadger 障害 12345 を分析し、修正を提案する」
- エラー コンテキストを取得: 「障害 12345 の最新の発生を完全なコンテキストで取得する」
- レビューと修正: 分析を使用してコードの問題を理解し、修正します
トラブルシューティング
よくある問題
- 認証エラー: APIキーが正しく、適切な権限があることを確認してください
- プロジェクトが見つかりません: プロジェクトIDが正しいことを確認してください
- 接続の問題: Honeybadger API へのネットワーク アクセスを確認してください
デバッグモード
エラー メッセージを表示するには、サーバーを直接実行します。
ログ
MCP 関連の問題については、カーソル ログを確認してください。
- macOS:
~/Library/Logs/Cursor/ - Windows:
%APPDATA%\Cursor\logs\ - Linux:
~/.config/Cursor/logs/
セキュリティノート
- APIキーを安全に保存し、バージョン管理にコミットしないでください
- 可能な場合は環境固有の API キーを使用する
- この統合には読み取り専用APIトークンの使用を検討してください
- APIキーを定期的にローテーションする
貢献
この MCP サーバーを拡張するには:
setupToolHandlers()メソッドに新しいツールを追加する- 対応するハンドラメソッドを実装する
- ツールリストとドキュメントを更新する
- Honeybadgerの設定で徹底的にテストする
サポート
以下の問題については:
- このMCPサーバー: コードと構成を確認してください
- Honeybadger API : Honeybadger APIドキュメントを参照してください
- カーソルMCP統合: カーソルのドキュメントを確認してください