Vanta

@mindstone/mcp-server-vanta

Vanta 合规 MCP 服务 — 通过 Vanta API 读取和写入漏洞、测试、控制、人员、供应商、文档和合规摘要。

一键安装

点击按钮后，宿主将提示你填写：VANTA_CLIENT_ID、VANTA_CLIENT_SECRET、VANTA_REGION、VANTA_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Vanta": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-vanta"
      ],
      "env": {
        "VANTA_CLIENT_ID": "",
        "VANTA_CLIENT_SECRET": "",
        "VANTA_REGION": "us",
        "VANTA_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

状态

• 版本： 0.3.1 · npm
• 身份验证： OAuth 客户端凭据授权（VANTA_CLIENT_ID + VANTA_CLIENT_SECRET）
• 工具： 25 个（涵盖漏洞、测试、控制、框架、策略、集成、风险场景、事件日志、人员、供应商、文档和合规摘要，其中 19 个用于读取，6 个用于写入）
• 接口： cloud-api
• 区域： 为保持向后兼容，接受 VANTA_REGION；所有标准租户（US、EU、AU）共用一个 API 主机（api.vanta.com）。此参数在本软件包中不用于路由。

安装

npx -y @mindstone/mcp-server-vanta

配置

启动服务前，请设置以下环境变量：

• VANTA_CLIENT_ID — Vanta OAuth 客户端 ID（必填）
• VANTA_CLIENT_SECRET — Vanta OAuth 客户端密钥（必填）
• VANTA_REGION — 为保持向后兼容而接受；所有标准租户（US、EU、AU）共用一个 API 主机（api.vanta.com）。此参数在本软件包中不用于路由。
• VANTA_REQUEST_TIMEOUT_MS — 请求超时时间，单位为毫秒（默认值为 60000）

如需生成凭据，请打开 Vanta Developer Console，创建一个新的 “Manage Vanta” 应用类型，并复制客户端 ID 和客户端密钥。

请求的 OAuth 作用域

连接器在每次令牌交换时都会请求以下作用域字符串：

vanta-api.all:read vanta-api.all:write vanta-api.documents:upload

vanta-api.documents:upload 是独立于 vanta-api.all:write 的作用域，也是 Vanta 文档上传端点所必需的。Vanta 为每个应用签发一个有效令牌，并根据应用验证作用域，因此无法针对每个工具请求更窄的作用域。我们有意接受这一权衡：每次安装都会包含上传作用域，即使该安装从不上传文档。

**从早期版本升级：**如果你的 Manage Vanta 应用无法请求 vanta-api.documents:upload，令牌交换将因 invalid_scope 失败，所有工具都将停止工作。请在 Developer Console 中更新（或重新创建）应用，使其能够请求全部三个作用域。

工具

读取

• vanta_list_vulnerabilities / vanta_get_vulnerability
• vanta_list_tests / vanta_get_test
• vanta_list_controls / vanta_get_control
• vanta_list_frameworks / vanta_get_framework
• vanta_list_policies / vanta_get_policy
• vanta_list_integrations
• vanta_list_risk_scenarios / vanta_get_risk_scenario
• vanta_list_event_logs
• vanta_list_people
• vanta_query_test_results
• vanta_get_compliance_summary
• vanta_list_vendors / vanta_get_vendor

写入

• vanta_create_vendor
• vanta_update_vendor
• vanta_attach_vendor_document
• vanta_deactivate_vulnerability_monitoring
• vanta_reactivate_vulnerability_monitoring
• vanta_upload_document

文件上传

Vanta 的上传端点使用 multipart/form-data 接收文件，因此这两个上传工具都需要一个公开的 https:// URL，并由连接器自行下载文件，再将文件字节转发给 Vanta：

• vanta_upload_document 通过 POST /v1/documents/{documentId}/uploads，将证据附加到现有的 Vanta 文档（document_id）。
• vanta_attach_vendor_document 通过 POST /v1/vendors/{vendorId}/documents，将文档附加到供应商（vendor_id，以及必填的 document_type，例如 SOC2_REPORT）。

Vanta 接受 .pdf、.docx、.jpg、.png 和 .xlsx 文件。

已知限制

• 上传文件会成为草稿。 Vanta 会将通过 API 上传的文件作为草稿附加到文档；审核员查看证据前，必须先在 Vanta 中提交该文档以供审核。工具结果会通过 submission_required 说明这一点，但连接器没有用于提交的工具。
• 无法创建文档。 vanta_upload_document 会将文件附加到 Vanta 中已存在的文档，但无法创建文档。
• 有限范围的 ID 回退扫描。 按 ID 直接执行 GET 返回 404 时，连接器会对集合进行游标分页，以查找该 ID，最多扫描 50 页（5,000 条记录）。超出此范围时，它会报告未找到，并附上扫描不完整的说明，而不是默默地只查第一页就放弃。

安全性

此服务会强制执行以下措施：

• 在 Vanta API 响应中的每个字符串到达模型之前，都会用 <untrusted-content> 信封包裹，并对闭合标签进行转义；但语法检查通过的结构性字面值（标识符、类似枚举的状态、ISO-8601 日期、http(s) URL、分页游标）除外，这些值必须保持原样，以便在后续工具调用中引用。这种默认拒绝的遍历方式意味着 Vanta 以后添加的字段，以及连接器不了解的、受攻击者影响的字段（例如由扫描器编写的软件包标识符），都会被安全地包裹，而不会以原始形式到达模型。API 和 OAuth 错误正文中的外部消息文本也会以相同方式包裹；凭据形式的值会被脱敏。
• 对两个上传工具执行仅限 HTTPS 的 URL 验证（拒绝 file:、localhost、RFC1918、链路本地地址（包括云元数据地址）、IPv6 环回地址／ULA，以及 DNS 记录解析到上述任一地址的主机名）。
• 限制文档获取范围：最多允许 3 次重定向，每一跳都会重新通过相同的 URL 防护进行验证；超时时间为 30 秒，并在流式传输期间强制执行 25 MB 大小上限（来源无法通过伪造 Content-Length 绕过上限）。
• Content-Type 处理采用标头清理，而非字节级 MIME 嗅探：不可信的来源标签会替换为 application/octet-stream。
• 对每种拒绝情况分别返回结构化错误，包括主机被阻止、非 HTTPS、超出大小限制、超时和重定向次数超限，而非通用错误。
• 速率限制为每分钟 50 个请求，并使用单航班令牌交换。
• 在客户端边界使用 Zod 验证外部响应（分页列表信封和 OAuth 令牌响应）；格式错误的载荷会返回结构化的 RESPONSE_INVALID／AUTH 错误，而非未经检查的类型转换。
• 响应截断至 25 KB，并使用二分查找进行裁剪；被截断的响应会移除 pageInfo，并提示使用更小的 page_size 重试，因为完整页面的游标会导致被裁掉的记录被静默跳过。
• 在所有错误消息中对 Bearer 令牌进行脱敏。

许可证

FSL-1.1-MIT