Trustabl Probe

Trustabl Probe MCP 服务

为编码 Agent 提供 Trustabl Probe： 它会为 Agent 工具拟定网络允许列表，并在网络受限的沙箱中运行该工具，以捕获仅在运行时才会出现的问题。每项发现都会附带修复提示，由你的 Agent 应用这些修复，因此无需模型或 API 密钥。

工具

工具	功能	是否会进行更改？
probe_check_setup	报告 Probe 二进制文件、Docker 和沙箱镜像是否已就绪，沙箱中可运行哪些语言，以及修复每项缺失内容的确切命令。	否
probe_install	下载 Probe 二进制文件（经过校验和验证）并拉取沙箱镜像。对于 Docker、OpenShell 或 Python，它只会返回要运行的命令及其注意事项。	是，见下文
probe_scan	扫描工具目录，并返回就绪度评分、拟定的网络允许列表，以及按严重程度从高到低排列并附有修复提示的发现。	在已扫描目录中写入四个报告文件

静态分析与沙箱

• 静态分析会读取代码并标记缺少超时设置、凭据硬编码或工具输出未经过滤等问题。它还会根据代码拟定网络允许列表（OpenShell 网络策略）。始终会运行，且无需其他条件。
• 沙箱还会在网络受限的环境中运行工具，以捕获崩溃、缺失的依赖项和被阻止的连接尝试。需要 Docker（或 NVIDIA OpenShell）。使用默认值 sandbox: "auto" 时，只要有可用的运行器，就会运行沙箱。对于看起来具有破坏性的工具（付款、删除、网络写入），除非传入 allow_write_tools: true，否则不会运行。

Docker 支持 Python、JavaScript/TypeScript、Go 和 Ruby；OpenShell 镜像支持 Python 和 Node。Shell 脚本始终仅进行静态分析。

安装

需要 Node.js 18 或更高版本。Docker 为可选项，可启用沙箱。

服务器随每个 Probe 发布版本一同提供，文件名为 trustabl-probe-mcp-<version>.tgz。示例使用 v0.2.4；请使用最新发布版本。

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "trustabl-probe": {
      "command": "npx",
      "args": ["-y", "https://github.com/trustabl/agent-network-access-probe/releases/download/v0.2.4/trustabl-probe-mcp-0.2.4.tgz"]
    }
  }
}

Claude Code：

claude mcp add trustabl-probe -- npx -y https://github.com/trustabl/agent-network-access-probe/releases/download/v0.2.4/trustabl-probe-mcp-0.2.4.tgz

**Claude Desktop：**从发布版本下载 trustabl-probe-mcp-<version>.mcpb 并打开以安装。或者在 claude_desktop_config.json 的 mcpServers 下，使用与 Cursor 示例相同的 command 和 args。

然后让你的 Agent 运行 probe_check_setup。

它会对你的机器进行哪些更改

• 将 Probe 二进制文件从与服务器相同的发布版本下载到 ~/.trustabl-probe/<version>/，并根据发布版本中的 checksums.txt 进行校验。校验不匹配会导致操作失败。
• 运行 probe_install 时或首次运行沙箱时，拉取沙箱镜像（python:3-slim、node:20-slim、golang:1.25-alpine、ruby:3-slim）。
• 在已扫描目录中写入 network_policies.draft.yaml、probe.findings.json、probe.profile.json 和 autofix-attestation.json。
• 绝不会自行安装 Docker、OpenShell 或 Python。它只会返回命令，你的 Agent 应在运行前征求你的许可。Docker Desktop 需要管理员权限，在 Windows 上可能需要重启；大型企业还需要付费订阅。

隐私政策

Trustabl 的隐私政策：https://trustabl.ai/privacy/

此服务如何处理你的数据：

• 收集： 不收集。它不会发送遥测数据，也不会调用模型。
• 你的代码： 代码会在你的计算机上读取和分析，绝不会上传。 证明签名已关闭，因此不会向透明度日志提交任何内容。
• 网络访问： 仅访问 GitHub（下载 Probe 发行版）、Docker Hub （获取沙盒映像），以及在 Python 工具声明了依赖项时访问 PyPI，以便在沙盒运行前 安装这些依赖项。被测试的工具运行时会阻止其网络访问。
• 存储： Probe 二进制文件会缓存到 ~/.trustabl-probe/，四个报告文件会写入已扫描目录。你可以随时删除其中任意内容。
• 第三方： 不会与 Trustabl 或其他任何人共享任何内容。
• 联系方式： https://github.com/trustabl/agent-network-access-probe/issues

设置

变量	默认值	用途
PROBE_VERSION	服务自带的发行版	要改用的 Probe 发行版，例如 v0.2.3 或 latest。需要 v0.2.3 或更高版本。
PROBE_BIN		本地 Probe 构建版本的路径；设置后会跳过下载
GITHUB_TOKEN		仅用于在 PROBE_VERSION 为 latest 时避免触发 GitHub 的匿名请求速率限制

开发

在 mcp/ 中：

cd server && npm ci && npm run build   # bundles to dist/index.js, which is committed
node test/smoke.mjs                    # handshake, tools/list, setup check
SMOKE_SCAN=1 node test/smoke.mjs       # also a static scan of test/fixture with the released Probe
PROBE_BIN=/path/to/autofix node test/smoke.mjs   # the same scan with a local Probe build

检出版本的版本号为 0.0.0，并使用最新的 Probe 发行版。发布工作流会在打包服务时设置实际版本号。

许可证

与 Probe 一样，采用 Apache-2.0 许可证。