Pangea MCP Server

🚀 Pangea MCP 服務器

Pangea MCP 服務器是一個基於 模型上下文協議（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 令牌的文檔，請參閱 服務令牌。
• 一個可訪問 Vault 的 Pangea API 令牌，用於在運行時獲取上述令牌。
• 一個採用 “Standard Audit Log Config” 架構 的 Pangea 安全審計日誌配置。有關如何創建新的安全審計日誌配置的文檔，請參閱 多服務配置。請記錄下配置 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 服務以啟用它。安全審計日誌提供透明、不可變且可加密驗證的防篡改審計日誌記錄。
5. 繼續使用默認的 Standard Audit Log 架構。
6. 在彈出的模態框中，會提示創建一個新的 Pangea API 令牌或擴展現有令牌。選擇 Create a new token。確保選中 Store token in Vault 複選框，然後點擊 Done。
7. 目標頁面上顯示的 Config ID 將在後續用作 PANGEA_AUDIT_CONFIG_ID 環境變量。
8. 現在，需要將第二個創建的令牌擴展到 Pangea 的其他服務。對於以下每個服務，點擊左側面板中的相應項目，在彈出的模態框中選擇 Extend an existing token。選擇上一步創建的令牌（不是僅為 Vault 創建的第一個令牌），然後點擊 Done。
   • AI Guard — 保護數據以及與大語言模型的交互。
   • Domain Intel — 檢索提交域名的情報數據。支持的提供商：DomainTools、CrowdStrike、WhoisXML API。
   • Embargo — 根據已知的制裁和貿易禁運列表檢查 IP 地址和國家代碼。
   • IP Intel — IP 監控。支持的提供商：Team CYMRU、CrowdStrike、Digital Element。
   • Redact — 通過使用定義的規則進行編輯來控制敏感信息。
   • URL Intel — 檢索已知 URL 的情報。支持的提供商：CrowdStrike。
   • 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 的值更新為安全審計日誌配置 ID。
4. 重啟 Claude Desktop。

📚 工具詳情

AI Guard

• prompt_guard — 分析並編輯文本，以避免模型被操縱、添加惡意內容和其他不良數據傳輸。

Domain Intel

• lookup_domain_reputation — 查找一個或多個域名的信譽評分。
• whois — 檢索域名的 WHOIS 信息（互聯網資源的註冊用戶或受讓人）。

Embargo

• check_ip_embargo — 根據已知的制裁和貿易禁運列表檢查一個或多個 IP 地址。
• check_iso_code_embargo — 根據已知的制裁和貿易禁運列表檢查一個國家代碼。

File Intel

• lookup_file_reputation — 檢索一組文件哈希的信譽評分。

IP Intel

• lookup_ip_address_reputation — 查找一個或多個 IP 地址的信譽評分。
• lookup_domain_from_ip_address — 檢索與一個或多個 IP 地址關聯的域名。
• is_proxy — 確定一個或多個 IP 地址是否來自代理。
• is_vpn — 確定一個或多個 IP 地址是否來自 VPN。
• geolocate — 對一個或多個 IP 地址進行地理定位或檢索其關聯的位置信息。

Redact

• redact — 從提供的文本中編輯敏感信息。

Secure Audit Log

• log_entry — 在安全審計日誌中創建一個日誌條目。
• search_log — 搜索安全審計日誌。

URL Intel

• lookup_url_reputation — 查找一個或多個 URL 的信譽評分。

Vault

• get_vault_item — 檢索 Vault 密鑰、機密信息、令牌或文件夾的詳細信息。
• list_vault_items — 檢索與給定過濾器匹配的 Vault 項目數組，包括機密信息、密鑰、令牌和文件夾及其通用詳細信息。
• delete_vault_item — 刪除 Vault 密鑰、機密信息、令牌或文件夾。
• generate_key — 生成對稱或非對稱密鑰。