tooltrust-mcp

你的智能体调用的每一个 MCP 工具都是一个攻击面——包括提示词注入、数据外泄、权限提升和供应链后门。ToolTrust 会在你的智能体信任工具之前扫描工具定义，并分配一个信任评级（A–F），让你了解风险。ToolTrust 是一个 MCP 服务器 和 CLI/CI 工具——它不是主机、网关或运行时代理。覆盖范围正在超越当前以 MCP 为中心的工作流；技能和其他智能体工具格式也在路线图中。

30 秒内扫描你的设置

将 ToolTrust 添加为 MCP 服务器，让你的智能体审计其自身的工具（stdio 传输——无网络监听；你的主机将其作为子进程启动）：

{
  "mcpServers": {
    "tooltrust": {
      "command": "npx",
      "args": ["-y", "tooltrust-mcp"]
    }
  }
}

然后询问你的智能体："Run tooltrust_scan_config"

它会读取你的 MCP 配置，并行连接到每个服务器，扫描每个工具，并返回包含评级和执行决策的风险报告——全程仅需几秒钟。

或者使用 CLI：

curl -sfL https://raw.githubusercontent.com/AgentSafe-AI/tooltrust-scanner/main/install.sh | bash
tooltrust-scanner scan --server "npx -y @modelcontextprotocol/server-filesystem /tmp"

Related MCP server: mcp-security-audit

示例快照（研究队列）

公开的 ToolTrust 目录 保存了当前的评级，并随着扫描规模的扩大进行汇总。一项已发表的研究展示了问题的严重性——207 个 MCP 服务器，3,235 个工具——这并非我们今天扫描的所有内容：

在该队列中，只有 10% 的服务器获得了干净的 A 级评级。 请参阅 tooltrust.dev 获取最新的全目录结果（此表格仅作为带标签的快照）。

它能检测什么

ToolTrust 针对此仓库中的每个工具定义运行 16 条静态分析规则（AS-001–AS-011，AS-013–AS-017）。AS-012（工具漂移）在将新的扫描结果与之前的运行进行比较时，会在 ToolTrust 目录 中进行评估。

完整规则详情：docs/RULES.md

工作原理

1. 解析 — 连接到实时 MCP 服务器（或读取 JSON 文件）并提取每个工具定义

2. 分析 — 针对每个工具的名称、描述、模式和权限运行所有 16 条规则

3. 评级 — 为每个工具分配数值风险分数和字母评级（A–F）

4. 执行 — 将每个评级映射到网关策略：ALLOW（允许）、REQUIRE_APPROVAL（需要批准）或 BLOCK（阻止）

纯静态分析。无 LLM 调用。数据不会离开你的机器（可选的 CVE 查询除外）。在毫秒内运行。确定性且可重现。

安装

# One-line install (macOS / Linux)
curl -sfL https://raw.githubusercontent.com/AgentSafe-AI/tooltrust-scanner/main/install.sh | bash

# Go
go install github.com/AgentSafe-AI/tooltrust-scanner/cmd/tooltrust-scanner@latest

# npx (no install needed)
npx -y tooltrust-mcp

MCP 工具

当作为 MCP 服务器运行时，ToolTrust 会向你的智能体公开以下工具：

CI / GitHub Actions

在你的流水线中阻止高风险的 MCP 服务器：

- name: Audit MCP Server
  uses: AgentSafe-AI/tooltrust-scanner@main
  with:
    server: "npx -y @modelcontextprotocol/server-filesystem /tmp"
    fail-on: "approval"

安装前扫描门禁

永远不要再将不受信任的 MCP 服务器添加到你的配置中：

# Scans the server, then auto-installs if Grade A/B, prompts on C/D, blocks on F
tooltrust-scanner gate @modelcontextprotocol/server-memory -- /tmp

# Replace `claude mcp add` with a scanned install
alias mcp-add='tooltrust-scanner gate'

完整的门禁选项和预提交钩子设置：docs/USAGE.md

为你的项目添加信任徽章

如果你的 MCP 服务器通过了 ToolTrust，请让大家知道：

[![ToolTrust Grade A](https://img.shields.io/badge/ToolTrust-Grade%20A-brightgreen)](https://www.tooltrust.dev/)

供应链警报： ToolTrust 会检测并阻止已确认受损的包，包括 LiteLLM v1.82.7/8 (TeamPCP 后门)、Trivy v0.69.4–v0.69.6 和 Langflow < 1.9.0。如果你遇到规则 AS-008 的 F 级评级，请立即删除该包并轮换所有凭据。

使用指南 · 开发者指南 · 贡献 · 部署与安全 · 更新日志 · 安全 · 许可证: MIT