Sentry Selfhosted MCP

🚀 自托管 Sentry の MCP サーバー

このサーバーは、自托管 Sentry インスタンスとのやり取りを目的とした、モデルコンテキストプロトコル（MCP）サーバーです。自托管 Sentry 環境における問題の情報取得や操作実行を支援します。

🚀 クイックスタート

このサーバーは、自托管 Sentry 環境における問題に関する情報を取得し、操作を実行するツールを提供します。環境変数から Sentry インスタンスの URL、認証トークン、組織識別子（スラッグ）を読み取ります。

✨ 主な機能

提供されているツール

以下のツールを利用できます。

1. get_sentry_issue

   • 説明：ID または URL を指定して、特定の Sentry 問題の詳細情報を取得します。
   • 入力：{ "issue_id_or_url": "string" }（例："12345" または "https://sentry.example.com/organizations/org/issues/12345/"）

2. list_sentry_projects

   • 説明：設定された Sentry 組織内のすべてのプロジェクトを一覧表示します。
   • 入力：{}（パラメーター不要）

3. list_sentry_issues

   • 説明：プロジェクトごとに問題を一覧表示し、必要に応じてフィルタークエリまたは状態で絞り込めます。
   • 入力：{ "project_slug": "string", "query": "string" (オプション), "status": "resolved" | "unresolved" | "ignored" (オプション) }

4. get_sentry_event_details

   • 説明：プロジェクト内の特定のイベント ID の詳細情報を取得します。
   • 入力：{ "project_slug": "string", "event_id": "string" }

5. update_sentry_issue_status

   • 説明：Sentry 問題の状態を更新します。
   • 入力：{ "issue_id": "string", "status": "resolved" | "ignored" | "unresolved" }

6. create_sentry_issue_comment

   • 説明：Sentry 問題にコメントを追加します。
   • 入力：{ "issue_id": "string", "comment_text": "string" }

📦 インストール

インストールと設定

1. プロジェクトのクローン/配置：このリポジトリをクローンするか、プロジェクトファイルを任意の場所に配置します。
2. 依存関係のインストール：プロジェクトディレクトリ (sentry-selfhosted-mcp) に移動し、以下のコマンドを実行します。

   cd <path/to/sentry-selfhosted-mcp>
   npm install
   

3. サーバーのビルド：プロジェクトディレクトリから TypeScript コードをコンパイルします。

   npm run build
   

   これにより、build/ ディレクトリに実行可能な JavaScript ファイルが作成されます。

📚 ドキュメント

設定

このサーバーには以下の環境変数が必要です。

• SENTRY_URL：自托管 Sentry インスタンスのベース URL（例：https://sentry.beoflow.app）。
• SENTRY_AUTH_TOKEN：Sentry API の認証トークン（issue:read、project:read、event:read、issue:write、comment:write などの必要なスコープを持っていることを確認）。
• SENTRY_ORG_SLUG：Sentry 組織の識別子（例：beoflow）。

MCP クライアントの設定例：

MCP クライアントの設定ファイル（例：VS Code 拡張機能の cline_mcp_settings.json または Claude.app の claude_desktop_config.json）に以下のエントリを追加します。

    "sentry-selfhosted-mcp": {
      "command": "node",
      "args": [
        "<full/path/to/sentry-selfhosted-mcp/build/index.js>"
      ],
      "env": {
        "SENTRY_URL": "YOUR_SENTRY_URL",
        "SENTRY_AUTH_TOKEN": "YOUR_SENTRY_AUTH_TOKEN",
        "SENTRY_ORG_SLUG": "YOUR_SENTRY_ORG_SLUG"
      }
    }