MCP Panther

🚀 Panther MCP Server

Pantherのモデルコンテキストプロトコル（MCP）サーバーは、以下の機能を提供します。

1. IDEから検出ルールを作成し、調整する
2. 自然言語を使用してセキュリティログを対話的にクエリする
3. 1つまたは複数のアラートをトリアージし、コメントを追加し、解決する

🚀 クイックスタート

このセクションでは、Panther MCP Serverの利用を開始するための基本的な手順を説明します。

✨ 主な機能

• IDEからの検出ルール作成と調整：IDEを使って検出ルールを作成し、調整することができます。
• 自然言語によるセキュリティログクエリ：自然言語を使ってセキュリティログを対話的にクエリすることができます。
• アラートのトリアージ、コメント、解決：1つまたは複数のアラートをトリアージし、コメントを追加し、解決することができます。

📦 インストール

Docker Setup (おすすめ)

最も簡単な方法は、事前にビルドされたDockerイメージを使用することです。

{
  "mcpServers": {
    "mcp-panther": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e", "PANTHER_INSTANCE_URL",
        "-e", "PANTHER_API_TOKEN",
        "--rm",
        "ghcr.io/panther-labs/mcp-panther"
      ],
      "env": {
        "PANTHER_INSTANCE_URL": "https://YOUR-PANTHER-INSTANCE.domain",
        "PANTHER_API_TOKEN": "YOUR-API-KEY"
      }
    }
  }
}

UVX Setup

Pythonユーザーは、uvxを使用してPyPIから直接実行することができます。

1. UVをインストールする
2. MCPクライアントを設定する

{
  "mcpServers": {
    "mcp-panther": {
      "command": "uvx",
      "args": ["mcp-panther"],
      "env": {
        "PANTHER_INSTANCE_URL": "https://YOUR-PANTHER-INSTANCE.domain",
        "PANTHER_API_TOKEN": "YOUR-PANTHER-API-TOKEN"
      }
    }
  }
}

💻 使用例

Cursor

こちらの手順に従って、プロジェクトまたはグローバルのMCP設定を構成します。このファイルをバージョン管理にチェックインしないようにしてください。

設定後、Cursorの設定 > MCPに移動して、実行中のサーバーを表示します。

ヒント

• 新しいルールを生成する場所を指定するには、@ 記号を使用してから特定のディレクトリを入力します。
• ツールの使用中により高い信頼性を得るには、特定のモデル（例：Claude 3.7 Sonnet）を選択してみましょう。
• MCPクライアントがPanther MCPサーバーからツールを見つけられない場合は、クライアントを再起動し、MCPサーバーが実行中であることを確認します。Cursorでは、MCPサーバーを更新して新しいチャットを開始します。

Claude Desktop

Claude Desktopで使用するには、claude_desktop_config.json を手動で設定します。

1. Claude Desktopの設定を開き、開発者タブに移動します。
2. [設定を編集] をクリックして、設定ファイルを開きます。
3. 次の設定を追加します。

{
  "mcpServers": {
    "mcp-panther": {
      "command": "uvx",
      "args": ["mcp-panther"],
      "env": {
        "PANTHER_INSTANCE_URL": "https://YOUR-PANTHER-INSTANCE.domain",
        "PANTHER_API_TOKEN": "YOUR-PANTHER-API-TOKEN"
      }
    }
  }
}

4. ファイルを保存し、Claude Desktopを再起動します。

問題が発生した場合は、こちらのトラブルシューティング手順 を試してみてください。

Goose

Goose（BlockのオープンソースAIエージェント）で使用するには、次のコマンドを実行します。

# Start Goose with the MCP server
goose session --with-extension "uvx mcp-panther"

📚 詳細ドキュメント

利用可能なツール

Alerts

Data

Rules

Schemas

Metrics

Users

セキュリティのベストプラクティス

Pantherは、以下のMCPのベストプラクティスを強く推奨します。

• 信頼できる、公式に署名されたMCPサーバーのみを実行する：実行前にデジタル署名またはチェックサムを検証し、ツールコードを監査し、非公式のパブリッシャーからのコミュニティツールを避けます。
• Panther APIトークンに厳格な最小特権を適用する：トークンを必要な最小限の権限にスコープし、IP許可リストまたはCIDR範囲にバインドして、漏洩した場合に無力化します。好みの間隔（例：30日ごと）で資格情報をローテーションします。
• 読み取り専用マウントでロックダウンされたサンドボックス（例：Docker）でMCPサーバーをホストする：これにより、侵害を最小限の影響範囲に限定します。
• Pantherへの資格情報アクセスを監視し、異常を監視する：Pantherルールを作成しましょう！
• mcp-scan でMCPサーバーをスキャンする：invariantlabsによる mcp-scan ツールを使用して、一般的な脆弱性をスキャンします。

Pantherの設定

1. PantherでAPIトークンを作成する

   • 設定（歯車アイコン）→ APIトークンに移動します。

   • 次の権限を持つ新しいトークンを作成します（最初は読み取り専用アプローチをおすすめします）。

   • 必要な権限を表示

2. 生成されたトークンを安全に保存する（例：1Password）
3. ブラウザからPantherインスタンスのURLを取得する（例：https://YOUR-PANTHER-INSTANCE.domain）
   • 注：これには https:// が含まれている必要があります。

🔧 トラブルシューティング

サーバーログを確認して、詳細なエラーメッセージを取得します：tail -n 20 -F ~/Library/Logs/Claude/mcp*.log。一般的な問題と解決策を以下に示します。

ツールの実行

• {"success": false, "message": "Failed to [action]: Request failed (HTTP 403): {\"error\": \"forbidden\"}"} エラーが発生した場合、APIトークンにツールが必要とする特定の権限がない可能性があります。
• PantherインスタンスのURLが正しく設定されていることを確認します。これは、MCPクライアントの config://panther リソースで確認できます。

📄 ライセンス

このプロジェクトは、Apache License 2.0の下でライセンスされています - 詳細については、LICENSEファイルを参照してください。

貢献者

このプロジェクトは、すべての貢献者のおかげで存在しています。Block の Tomasz Tchorz と Glenn Edwards に特別な感謝を送ります。彼らは、Pantherとの共同オープンソース取り組みとしてMCP-Pantherを立ち上げる核心的な役割を果たしました。

貢献者の完全なリストについては、CONTRIBUTORS.md を参照してください。

貢献

MCP-Pantherの改善に貢献することを歓迎します！以下の方法でお手伝いいただけます。

1. 問題の報告：バグや機能要求について問題を開きます。
2. プルリクエストの送信：リポジトリをフォークし、バグ修正や新機能のプルリクエストを送信します。
3. ドキュメントの改善：ドキュメントをより明確で包括的にするのを手伝ってください。
4. ユースケースの共有：MCP-Pantherの使用方法と改善点を教えてください。

貢献がコーディング標準に従い、適切なテストとドキュメントを含むことを確認してください。