MCP Secops V3

🚀 クロニクル セキュリティ運用 MCP サーバー

このサーバーは、Google の Chronicle セキュリティ運用ツールキットとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。 MCP 情報

🚀 クイックスタート

この MCP サーバーを使用することで、Google の Chronicle セキュリティ運用ツールキットとのやり取りを効率化することができます。以下に、Claude デスクトップ版でのインストール方法や、サーバーの機能、インストール手順、使用方法などを説明します。

📦 インストール

Claude デスクトップ版でのインストール

Claude デスクトップ版でこの MCP サーバーを使用するには、以下の手順に従ってください。

1. Claude デスクトップ版をインストールします。
2. Claude デスクトップ版を開き、メニューから「設定」を選択します。
3. 左側のバーで「開発者」をクリックし、「編集設定」をクリックします。
4. 以下の設定を使用して、claude_desktop_config.json ファイルを更新します（パスは実際のパスに置き換えてください）。

{
  "mcpServers": {
    "secops-mcp": {
      "command": "/path/to/your/uv",
      "args": [
        "--directory",
        "/path/to/your/mcp-secops-v3",
        "run",
        "secops_mcp.py"
      ],
      "env": {
        "CHRONICLE_PROJECT_ID": "あなたの Google Cloud プロジェクト ID",
        "CHRONICLE_CUSTOMER_ID": "あなたの Chronicle 顧客 ID",
        "CHRONICLE_REGION": "us"
      }
    }
  }
}

5. 以下の項目を更新してください。

   • uv のパス（which uv を使用して見つけます）
   • このリポジトリがあるディレクトリのパス
   • あなたの Chronicle 認証情報（プロジェクト ID、顧客 ID、リージョン）

6. ファイルを保存し、Claude デスクトップ版を再起動します。

7. これで、Claude デスクトップ画面にハンマーアイコンが表示され、MCP サーバーがアクティブになっていることを確認できます。

Smithery を通じたインストール

Smithery を通じて mcp-secops-v3 を自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @emeryray2002/mcp-secops-v3 --client claude

手動インストール

手動でインストールするには、以下の手順に従ってください。

1. パッケージをインストールします。

pip install -e .

2. 環境変数を設定します。

export CHRONICLE_PROJECT_ID="あなたの Google Cloud プロジェクト ID"
export CHRONICLE_CUSTOMER_ID="あなたの Chronicle 顧客 ID"
export CHRONICLE_REGION="us"  # またはあなたのリージョン

✨ 主な機能

セキュリティツール

• search_security_events：Chronicle 内のセキュリティイベントを検索し、カスタムクエリをサポートします。
• get_security_alerts：Chronicle のセキュリティアラートを取得します。
• lookup_entity：エンティティ情報（IP、ドメイン名、ハッシュなど）を検索します。
• list_security_rules：Chronicle のセキュリティ検出ルールをリストします。
• get_ioc_matches：指標（IoCs）の一致項目を取得します。

💻 使用例

基本的な使用法

MCP サーバーを起動するには、以下のコマンドを実行します。

python main.py

API 機能

MCP サーバーは、以下の機能を提供します。

1. セキュリティイベントの検索：Chronicle 内のセキュリティイベントを検索します。
2. セキュリティアラートの取得：Chronicle のセキュリティアラートを取得します。
3. エンティティの検索：エンティティ情報（IP、ドメイン名、ハッシュなど）を検索します。
4. セキュリティルールのリスト：Chronicle のセキュリティ検出ルールをリストします。
5. IoCs の一致項目の取得：指標の一致項目を取得します。

🔧 技術詳細

• Python バージョン：Python 3.11 以上が必要です。
• Google Cloud アカウント：Chronicle セキュリティ運用が有効な Google Cloud アカウントが必要です。
• 認証設定：正しく認証情報を設定する必要があります。

> ⚠️ **重要提示**
> 
> すべてのコード例と設定指示には英語の変数名を使用し、コメントと説明部分のみを日本語に翻訳しています。