sentry-selfhosted-mcp

sentry-selfhosted-mcp

セルフホスト型 Sentry インスタンスとのやり取りに特化した Model Context Protocol（MCP）サーバーです。

概要

このサーバーは、セルフホスト型 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" (optional), "status": "resolved" | "unresolved" | "ignored" (optional) }

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
   

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

設定

このサーバーを利用するには、次の環境変数を設定する必要があります。

• 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"
      },
      "disabled": false,
      "autoApprove": [],
      "transportType": "stdio"
    }

YOUR_SENTRY_URL、YOUR_SENTRY_AUTH_TOKEN、YOUR_SENTRY_ORG_SLUG を実際の値に置き換えてください。

設定ファイルを更新すると、MCP クライアントは自動的にサーバーに接続します。