MCP Sentry: A Sentry MCP Server

🚀 mcp-sentry：Sentry MCPサーバー

このサーバーは、Sentry.ioから問題を取得して分析するためのモデルコンテキストプロトコル（MCP）サーバーです。アプリケーション内のエラーレポート、スタックトレース、その他のデバッグ情報を確認するためのツールを提供します。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントがSentryの問題にアクセスし、詳細な問題情報を提供することができます。

✨ 主な機能

ツール

1. get_sentry_issue

   • IDまたはURLに基づいて、Sentryの問題を取得して分析します。
   • 入力:
     • issue_id_or_url (文字列): Sentryの問題IDまたはURL
   • 戻り値: 以下の詳細情報を含む問題の詳細:
     • タイトル
     • 問題ID
     • 状態
     • レベル
     • 初回発生タイムスタンプ
     • 最近発生タイムスタンプ
     • イベントカウント
     • 完全なスタックトレース

2. sentry - issue

   • Sentryから問題の詳細を取得します。
   • 入力:
     • issue_id_or_url (文字列): Sentryの問題IDまたはURL
   • 戻り値: 会話コンテキストとしてのフォーマットされた問題の詳細情報

📦 インストール

前提条件

• Node.js 14以上
• 認証トークン付きのSentryアカウント

npmを使用する場合

npm install -g mcp-sentry

インストールが完了したら、以下のように実行できます。

mcp-sentry --auth-token あなたの_SENTRY_TOKEN

または、環境変数を使用することもできます。

SENTRY_TOKEN=あなたの_SENTRY_TOKEN mcp-sentry

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

npx mcp-sentry --auth-token あなたの_SENTRY_TOKEN

📚 ドキュメント

開発

プロジェクト構造

mcp-sentry/
├── src/
│   ├── index.ts           # エントリーファイル
│   ├── server.ts          # MCPサーバーの実装
│   ├── sentry-client.ts   # Sentry APIクライアント
│   ├── models.ts          # データモデル
│   ├── utils.ts           # ユーティリティ関数
│   └── types/             # 型定義
├── build/                 # コンパイルされたJavaScriptファイル（npxでの直接使用をサポートするためにリポジトリに含まれています）
├── package.json
├── tsconfig.json
└── README.md

ビルド

npm run build

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

開発モードでの実行

npm run dev -- --auth-token あなたの_SENTRY_TOKEN

認証

このサーバーは、Sentry APIにアクセスするためにSentry認証トークンが必要です。トークンを提供する方法は2つあります。

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

   mcp-sentry --auth-token あなたの_SENTRY_TOKEN
   

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

   SENTRY_TOKEN=あなたの_SENTRY_TOKEN mcp-sentry
   

Claude Desktopとの連携

以下の内容をClaude Desktopの設定に追加します。

"mcpServers": {
  "sentry": {
    "command": "mcp-sentry",
    "args": ["--auth-token", "あなたの_SENTRY_TOKEN"]
  }
}

VS Codeとの連携

VS Codeでは、このサーバーをサポートするためにタスクを設定できます。例えば:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Sentry MCPサーバーを起動する",
      "type": "shell",
      "command": "npx mcp-sentry --auth-token ${env:SENTRY_TOKEN}",
      "args": []
    }
  ]
}

プロジェクトへの貢献

このプロジェクトへの貢献を歓迎します！ 詳細は CONTRIBUTING.md を参照してください。

📄 ライセンス

[ここにライセンス情報を記載]

連絡先

• GitHub: プロジェクトリポジトリ
• メール: your.email@example.com