Sentry

英語 中文

以下は、mcp-sentry-custom プロジェクトの README.md を、明確さ、正確さ、プロフェッショナルな内容を保つよう適切に整えた改訂版です。標準的な Markdown の規則に従い、内容を論理的なセクションにまとめています。

---

mcp-sentry-custom：Sentry MCP サーバー

概要

mcp-sentry-custom は、Sentry.io またはセルフホスト可能な Sentry インスタンスから、問題を取得して分析するための Model Context Protocol（MCP）サーバーです。このサーバーは、Sentry アカウントからエラーレポート、スタックトレース、その他のデバッグ情報を直接確認するためのツールを提供します。

機能

ツール

1. get_sentry_issue

   • 説明：ID または URL で指定した Sentry の問題を取得して分析します。
   • 入力：
     • issue_id_or_url（string）：分析対象の Sentry の問題 ID または完全な URL。
   • 戻り値：以下を含む、問題の詳細情報：
     • タイトル
     • 問題 ID
     • ステータス
     • レベル
     • 初回検出時刻
     • 最終検出時刻
     • イベント数
     • 完全なスタックトレース

2. get_list_issues

   • 説明：特定のプロジェクトの Sentry の問題一覧を取得して分析します。
   • 入力：
     • project_slug（string）：Sentry プロジェクトのスラッグ。
     • organization_slug（string）：Sentry 組織のスラッグ。
   • 戻り値：以下の詳細情報を含む問題一覧：
     • タイトル
     • 問題 ID
     • ステータス
     • レベル
     • 初回検出時刻
     • 最終検出時刻
     • イベント数
     • 問題の基本情報

プロンプト

1. sentry-issue
   • 説明：会話のコンテキストで使用するために、Sentry から整形済みの問題の詳細を取得します。
   • 入力：
     • issue_id_or_url（string）：Sentry の問題 ID または URL。
   • 戻り値：整形済みの問題の詳細。

インストール

Smithery を使用してインストール

Smithery を使って、Claude Desktop 用の mcp-sentry-custom を自動的にインストールするには：

npx -y @smithery/cli install @javaDer/mcp-sentry-custom --client claude

uv を使用（推奨）

uv を使用する場合、特別なインストールは必要ありません。uvx を使って mcp-sentry-custom を直接実行できます：

uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

pip を使用

または、pip を使って mcp-sentry-custom をインストールします：

pip install mcp-sentry-custom

または、uv を使用します：

uv pip install -e .

インストール後、スクリプトとして実行します：

python -m mcp_sentry

設定

Claude Desktop での使用

claude_desktop_config.json に以下を追加します：

uvx を使用

{
  "mcpServers": {
    "sentry": {
      "command": "uvx",
      "args": [
        "mcp-sentry-custom",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Docker を使用

{
  "mcpServers": {
    "sentry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "mcp/sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

pip によるインストール

{
  "mcpServers": {
    "sentry": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Zed での使用

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

uvx を使用

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-sentry-custom",
          "--auth-token", "YOUR_SENTRY_TOKEN",
          "--project-slug", "YOUR_PROJECT_SLUG",
          "--organization-slug", "YOUR_ORGANIZATION_SLUG",
          "--sentry-url", "YOUR_SENTRY_URL"
        ]
      }
    }
  }
}

pip によるインストール

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

カスタムパスを指定して pip でインストール

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ],
      "env": {
        "PYTHONPATH": "path/to/mcp-sentry-custom/src"
      }
    }
  }
}

デバッグ

MCP インスペクターを使用してサーバーをデバッグします。

uvx でインストールした場合

npx @modelcontextprotocol/inspector uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

ローカル開発の場合

パッケージを特定のディレクトリにインストールした場合、または開発中の場合：

cd path/to/mcp-sentry-custom/src
npx @modelcontextprotocol/inspector uv run mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

または、カスタムディレクトリを指定します：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sentry-custom/src run mcp_sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

フォーク元

このプロジェクトのフォーク元：
https://github.com/modelcontextprotocol/servers/tree/main/src/sentry

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。

---

変更点に関するメモ

1. 書式：読みやすさを高めるため、適切なMarkdownの見出し、リスト、コードブロックを使用しました。
2. 一貫性：用語を統一し（例：mcp_sentry と mcp-sentry-custom）、冗長な <TEXT> タグと <JSON> タグを削除しました。
3. 明確さ：「概要」や「機能」などのセクションを、簡潔で正確な表現に書き直しました。
4. 完全性：未完の文を修正し、すべての設定例が適切な構成になるようにしました。
5. プロフェッショナルなトーン：よりフォーマルで洗練された印象になるよう、表現を調整しました。

さらに修正をご希望でしたら、お知らせください！