Pangea MCP Server

🚀 Pangea MCP Server

このサーバーは、Model Context Protocol (MCP) を介してPangea APIとの統合を提供します。

🚀 クイックスタート

🔍 前提条件

• Node.js v22.15.0 以上。
• AI Guard、Domain Intel、Embargo、IP Intel、Redact、Secure Audit Log、URL Intel、およびVaultのすべてにアクセスできるPangea APIトークン。このトークンはPangea Vaultに保存する必要があります。Pangea APIトークンの作成と管理方法については、Service Tokens を参照してください。
• VaultにアクセスできるPangea APIトークン。これは実行時に上記のトークンを取得するために使用されます。
• Audit Schema の「Standard Audit Log Config」[スキーマ] を持つPangea Secure Audit Log構成。新しいSecure Audit Log構成の作成方法については、Multiple Service Configurations を参照してください。後で使用するために構成IDをメモしておいてください。

最初のAPIトークンは次のように表示される場合があります。

🛠️ Pangeaの最初からのセットアップ

このセクションでは、このMCPサーバー用に新しいPangeaアカウントをセットアップする方法について説明します。

1. https://pangea.cloud/signup でPangeaアカウントを作成します。アカウント作成プロセス中に、組織（トップレベルグループ）とプロジェクト（個々のアプリ）も作成されます。「Get started with a common service」ダイアログでは、Skip ボタンをクリックして開発者コンソールにリダイレクトします。
2. 開発者コンソールで、左側のパネルにサービスのリストが表示されます。Vault サービスをクリックして有効にします。Vaultは、シークレット、暗号化キー、およびPangea APIトークンの安全な保存を提供します。
3. モーダルで、新しいPangea APIトークンを作成するか、既存のトークンを拡張するかを選択するプロンプトが表示されます。Create a new token を選択し、Done をクリックします。このトークンは後で PANGEA_VAULT_TOKEN 環境変数として使用されます。
4. 左側のパネルで、Secure Audit Log サービスをクリックして有効にします。Secure Audit Logは、透明性、不変性、および暗号学的に検証可能な改ざん防止監査ログを提供します。
5. デフォルトの Standard Audit Log スキーマを続けます。
6. モーダルで、新しいPangea APIトークンを作成するか、既存のトークンを拡張するかを選択するプロンプトが表示されます。Create a new token を選択します。Store token in Vault チェックボックスがチェックされていることを確認し、Done をクリックします。
7. 遷移先のページに表示される Config ID は、後で PANGEA_AUDIT_CONFIG_ID 環境変数として使用されます。
8. ここで作成された2番目のトークンを、Pangeaの他のサービスすべてに拡張する必要があります。以下の各サービスについて、左側のパネルの該当する項目をクリックし、表示されるモーダルで Extend an existing token を選択します。前の手順で作成されたトークン（Vault用に作成された最初のトークンではない）を選択し、Done をクリックします。
   1. AI Guard — データとLLMとのやり取りを保護します。
   2. Domain Intel — 提出されたドメインのインテリジェンスデータを取得します。サポートされているプロバイダー: DomainTools、CrowdStrike、WhoisXML API。
   3. Embargo — IPアドレスと国コードを既知の制裁と貿易禁輸リストと照合します。
   4. IP Intel — IP監視を行います。サポートされているプロバイダー: Team CYMRU、CrowdStrike、Digital Element。
   5. Redact — 定義されたルールを使用してレダクションを行い、機密情報を管理します。
   6. URL Intel — 既知のURLに関するインテリジェンスを取得します。サポートされているプロバイダー: CrowdStrike。
   7. Vault — シークレット、暗号化キー、およびPangea APIトークンの安全な保存を提供します。
9. https://console.pangea.cloud/project/credentials に移動します。上記のすべてのサービスに拡張されたトークンは、Vault列の下に「Stored」インジケーターとともに表示されるはずです。それをクリックして、そのトークンを含むVaultアイテムに直接移動します。このアイテムの ID は、PANGEA_VAULT_ITEM_ID 環境変数として使用されます。

💻 Claude Desktopでの使用方法

以下の構成ファイルを編集します（存在しない場合は作成します）:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

ファイルの内容を次のものに置き換えます（またはマージします）:

{
  "mcpServers": {
    "pangea": {
      "command": "npx",
      "args": ["-y", "@pangeacyber/mcp-server"],
      "env": {
        "PANGEA_VAULT_TOKEN": "pts_00000000000000000000000000000000",
        "PANGEA_VAULT_ITEM_ID": "pvi_00000000000000000000000000000000",
        "PANGEA_AUDIT_CONFIG_ID": "pci_00000000000000000000000000000000"
      }
    }
  }
}

1. PANGEA_VAULT_TOKEN の値をPangea Vault APIトークンに更新します。
2. PANGEA_VAULT_ITEM_ID の値を、他のすべてのPangeaサービスを呼び出すために使用されるAPIトークンを含むVaultアイテムIDに更新します。
3. PANGEA_AUDIT_CONFIG_ID の値をSecure Audit Log構成IDに更新します。
4. Claude Desktopを再起動します。

🔧 ツール

✨ AI Guard

• prompt_guard — テキストを分析してレダクションし、モデルの操作、悪意のあるコンテンツの追加、およびその他の望ましくないデータ転送を回避します。

✨ Domain Intel

• lookup_domain_reputation — 1つまたは複数のドメインの評判スコアを検索します。
• whois — ドメインのWHOIS（インターネットリソースの登録ユーザーまたは割り当て先）を取得します。

✨ Embargo

• check_ip_embargo — 1つまたは複数のIPアドレスを既知の制裁と貿易禁輸リストと照合します。
• check_iso_code_embargo — 国コードを既知の制裁と貿易禁輸リストと照合します。

✨ File Intel

• lookup_file_reputation — 一連のファイルハッシュの評判スコアを取得します。

✨ IP Intel

• lookup_ip_address_reputation — 1つまたは複数のIPアドレスの評判スコアを検索します。
• lookup_domain_from_ip_address — 1つまたは複数のIPアドレスに関連付けられたドメイン名を取得します。
• is_proxy — 1つまたは複数のIPアドレスがプロキシから発信されたかどうかを判断します。
• is_vpn — 1つまたは複数のIPアドレスがVPNから発信されたかどうかを判断します。
• geolocate — 1つまたは複数のIPアドレスの地理的位置を特定し、または関連する位置情報を取得します。

✨ Redact

• redact — 提供されたテキストから機密情報をレダクションします。

✨ Secure Audit Log

• log_entry — Secure Audit Logにログエントリを作成します。
• search_log — Secure Audit Logを検索します。

✨ URL Intel

• lookup_url_reputation — 1つまたは複数のURLの評判スコアを検索します。

✨ Vault

• get_vault_item — Vaultのキー、シークレット、トークン、またはフォルダの詳細を取得します。
• list_vault_items — 与えられたフィルターに一致するVaultアイテム（シークレット、キー、トークン、およびフォルダ）の配列を取得し、それらの共通の詳細を取得します。
• delete_vault_item — Vaultのキー、シークレット、トークン、またはフォルダを削除します。
• generate_key — 対称または非対称キーを生成します。