mcp-sentry: A Sentry MCP Server

mcp-sentry：Sentry MCP サーバー

Sentry.io からイシューを取得して分析するための Model Context Protocol サーバーです。このサーバーは、Sentry アカウントからエラーレポート、スタックトレース、その他のデバッグ情報を調査するためのツールを提供します。

概要

この MCP サーバーを使うと、AI アシスタントが Sentry のイシューにアクセスして分析し、アプリケーションのエラーに関する詳細な情報を取得できます。

ツール

1. get_sentry_issue

   ID または URL を指定して Sentry のイシューを取得し、分析します

   入力：

   • issue_id_or_url（string）：分析する Sentry のイシュー ID または URL

   返される内容： 次の情報を含むイシューの詳細：

   • タイトル
   • イシュー ID
   • ステータス
   • レベル
   • 初回検出日時
   • 最終検出日時
   • イベント数
   • スタックトレース全体

プロンプト

1. sentry-issue

   Sentry からイシューの詳細を取得します

   入力：

   • issue_id_or_url（string）：Sentry のイシュー ID または URL

   返される内容： 会話のコンテキストとして整形されたイシューの詳細

インストール

前提条件

• Node.js 14 以降
• 認証トークンを持つ Sentry アカウント

npm を使用する場合

npm install -g mcp-sentry

インストール後、コマンドとして実行できます：

mcp-sentry --auth-token YOUR_SENTRY_TOKEN

または、環境変数を使用して実行できます：

SENTRY_TOKEN=YOUR_SENTRY_TOKEN mcp-sentry

npx を使用する場合（インストール不要）

npx mcp-sentry --auth-token YOUR_SENTRY_TOKEN

開発

プロジェクト構成

mcp-sentry/
├── src/
│   ├── index.ts           # Main entry point
│   ├── server.ts          # MCP server implementation
│   ├── sentry-client.ts   # Sentry API client
│   ├── models.ts          # Data models
│   ├── utils.ts           # Utility functions
│   └── types/             # Type definitions
├── build/                 # Compiled JavaScript files (included in the repository for direct npx execution)
├── package.json
├── tsconfig.json
└── README.md

ビルド

npm run build

注：一般的な Node.js プロジェクトとは異なり、ユーザーが自分でプロジェクトをビルドしなくても npx で直接実行できるように、このリポジトリにはビルドディレクトリがコミットされています。

開発モードでの実行

npm run dev -- --auth-token YOUR_SENTRY_TOKEN

認証

このサーバーで Sentry API にアクセスするには、Sentry 認証トークンが必要です。トークンは次の 2 つの方法で指定できます：

1. --auth-token コマンドラインオプションを使用する：

   mcp-sentry --auth-token YOUR_SENTRY_TOKEN
   

2. SENTRY_TOKEN 環境変数を使用する：

   SENTRY_TOKEN=YOUR_SENTRY_TOKEN mcp-sentry
   

Claude Desktop での使用

これを Claude Desktop の設定に追加します：

"mcpServers": {
  "sentry": {
    "command": "mcp-sentry",
    "args": ["--auth-token", "YOUR_SENTRY_TOKEN"]
  }
}

Zed での使用

Zed の settings.json に追加します：

"context_servers": [
  "mcp-server-sentry": {
    "command": {
      "path": "mcp-sentry",
      "args": ["--auth-token", "YOUR_SENTRY_TOKEN"]
    }
  }
],

デバッグ

MCP インスペクターを使ってサーバーをデバッグできます：

npx @modelcontextprotocol/inspector mcp-sentry --auth-token YOUR_SENTRY_TOKEN

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。つまり、MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。