Pangea MCP Server

Pangea MCP 服务

一个与 Pangea API 集成的 Model Context Protocol (MCP) 服务。

前提条件

• Node.js v24.11.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 Secure Audit Log 配置。请参阅[多个服务配置][]，了解如何创建新的 Secure Audit Log 配置。记下 配置 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. 现在必须将创建的第二个令牌扩展到 Pangea 的其余 服务。对于以下每项服务，点击左侧面板中相应的项目，在弹出的对话框中选择 Extend an existing token。选择上一步创建的令牌（而不是仅为 Vault 创建的第一个令牌），然后 点击 Done。
   1. AI Guard — 保护数据以及与大模型的交互。
   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 的值更新为包含 API 令牌的 Vault 项目 ID，该令牌将用于调用所有其他 Pangea 服务。
3. 将 PANGEA_AUDIT_CONFIG_ID 的值更新为 Secure Audit Log 配置 ID。
4. 重启 Claude Desktop。

作为 HTTP 服务运行

npx @pangeacyber/mcp-server --transport httpStream --port 8080

添加 Pangea AuthN

使用可流式传输的 HTTP 传输方式运行服务时，可以选择通过 Pangea AuthN 为服务添加身份验证。若要启用此功能，请设置 --authn 标志，并设置以下环境变量：

• PANGEA_AUTHN_ISSUER — Pangea AuthN 颁发者 URL。
• PANGEA_AUTHN_CLIENT_ID — Pangea AuthN 客户端 ID。
• PANGEA_AUTHN_CLIENT_SECRET — Pangea AuthN 客户端密钥。

客户端设置

1. 前往 Pangea AuthN 控制面板。
2. 在左侧面板中，点击 OAuth Server。
3. 点击右侧的 + OAuth Client 按钮，开始创建新的 OAuth 客户端。
   • Name： 为客户端指定一个易于识别的名称，该名称会显示在 OAuth Server 设置中的客户端列表里。此名称可以随时更新。
   • Grant Type： 必须为 Authorization Code。
   • Response Types： 只需选择 Code。
   • Allowed Redirect URIs： 输入 http://localhost:8000/pangea/callback。 请注意，对于生产环境中的 MCP 服务，应使用服务的远程地址（例如 https://mcp.example.org/pangea/callback），而非 localhost 地址。
   • Allowed Scopes & Default Scopes： openid。
4. Client ID 和 Client Secret 分别对应环境变量 PANGEA_AUTHN_CLIENT_ID 和 PANGEA_AUTHN_CLIENT_SECRET。AuthN Overview 页面上显示的 Hosted Login URL 对应环境变量 PANGEA_AUTHN_ISSUER。

工具

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 — 在 Secure Audit Log 中创建日志条目。
• search_log — 搜索 Secure Audit Log。

URL Intel

• lookup_url_reputation — 查询一个或多个 URL 的信誉评分。

Vault

• get_vault_item — 获取 Vault 密钥、机密、令牌或文件夹的详细信息。
• list_vault_items — 获取与给定筛选条件匹配的 Vault 项目数组，包括机密、密钥、令牌和文件夹，以及它们的常见详细信息。
• delete_vault_item — 删除 Vault 密钥、机密、令牌或文件夹。
• generate_key — 生成对称或非对称密钥。