tooltrust-mcp

Cada herramienta MCP que llama su agente es una superficie de ataque: inyección de prompts, exfiltración de datos, escalada de privilegios, puertas traseras en la cadena de suministro. ToolTrust analiza las definiciones de las herramientas antes de que su agente confíe en ellas y les asigna una calificación de confianza (A–F) para que conozca el riesgo. ToolTrust es un servidor MCP y una herramienta CLI/CI; no es un host, una puerta de enlace ni un proxy de tiempo de ejecución. La cobertura se está expandiendo más allá de los flujos de trabajo centrados en MCP actuales; las habilidades y otros formatos de herramientas para agentes están en la hoja de ruta.

Analice su configuración en 30 segundos

Agregue ToolTrust como servidor MCP y deje que su agente audite sus propias herramientas (transporte stdio; sin escucha de red; su host lo inicia como un subproceso):

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

Luego pregúntele a su agente: "Run tooltrust_scan_config"

Lee su configuración de MCP, se conecta a cada servidor en paralelo, escanea cada herramienta y devuelve un informe de riesgos con calificaciones y decisiones de cumplimiento, todo en segundos.

O utilice la 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

Instantánea de ejemplo (cohorte de investigación)

El Directorio ToolTrust público contiene las calificaciones actuales y los agregados a medida que el escaneo escala. Una pasada de investigación publicada ilustra la forma del problema: 207 servidores MCP, 3,235 herramientas; no es un recuento exhaustivo de todo lo que escaneamos hoy:

Solo el 10% de los servidores en esa cohorte tenían una calificación A limpia. Consulte tooltrust.dev para obtener resultados actualizados en todo el directorio (y utilice esta tabla solo como una instantánea etiquetada).

Lo que detecta

ToolTrust ejecuta 16 reglas de análisis estático contra cada definición de herramienta en este repositorio (AS-001–AS-011, AS-013–AS-017). AS-012 (deriva de herramientas) se evalúa en el Directorio ToolTrust cuando se comparan nuevos resultados de escaneo con ejecuciones anteriores.

Detalles completos de las reglas: docs/RULES.md

Cómo funciona

1. Analizar — Se conecta a un servidor MCP en vivo (o lee un archivo JSON) y extrae cada definición de herramienta

2. Analizar — Ejecuta las 16 reglas contra el nombre, descripción, esquema y permisos de cada herramienta

3. Calificar — Asigna una puntuación de riesgo numérica y una calificación de letra (A–F) por herramienta

4. Hacer cumplir — Asigna cada calificación a una política de puerta de enlace: ALLOW, REQUIRE_APPROVAL o BLOCK

Análisis estático puro. Sin llamadas a LLM. Ningún dato sale de su máquina (excepto las búsquedas opcionales de CVE). Se ejecuta en milisegundos. Determinista y reproducible.

Instalación

# 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

Herramientas MCP

Cuando se ejecuta como servidor MCP, ToolTrust expone estas herramientas a su agente:

CI / GitHub Actions

Bloquee servidores MCP arriesgados en su canalización:

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

Puerta de escaneo antes de la instalación

Nunca vuelva a agregar un servidor MCP no confiable a su configuración:

# 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'

Opciones completas de puerta y configuración de gancho de pre-commit: docs/USAGE.md

Agregue una insignia de confianza a su proyecto

Si su servidor MCP pasa ToolTrust, hágaselo saber a los demás:

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

Alerta de cadena de suministro: ToolTrust detecta y bloquea paquetes comprometidos confirmados, incluidos LiteLLM v1.82.7/8 (puerta trasera TeamPCP), Trivy v0.69.4–v0.69.6 y Langflow < 1.9.0. Si encuentra una calificación F con la regla AS-008, elimine el paquete inmediatamente y rote todas las credenciales.

Guía de uso · Guía para desarrolladores · Contribución · Despliegue y seguridad · Registro de cambios · Seguridad · Licencia: MIT