tooltrust-mcp

Jedes MCP-Tool, das Ihr Agent aufruft, stellt eine Angriffsfläche dar – Prompt-Injection, Datenexfiltration, Privilegieneskalation, Backdoors in der Lieferkette. ToolTrust scannt Tool-Definitionen, bevor Ihr Agent ihnen vertraut, und weist eine Vertrauensnote (A–F) zu, damit Sie das Risiko kennen. ToolTrust ist ein MCP-Server und ein CLI/CI-Tool – kein Host, Gateway oder Laufzeit-Proxy. Die Abdeckung wird über die heutigen MCP-fokussierten Workflows hinaus erweitert; Skills und weitere Agent-Tool-Formate stehen auf der Roadmap.

Scannen Sie Ihr Setup in 30 Sekunden

Fügen Sie ToolTrust als MCP-Server hinzu und lassen Sie Ihren Agent seine eigenen Tools prüfen (stdio-Transport – kein Netzwerk-Listener; Ihr Host startet es als Subprozess):

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

Fragen Sie dann Ihren Agent: "Run tooltrust_scan_config"

Es liest Ihre MCP-Konfiguration, verbindet sich parallel mit jedem Server, scannt jedes Tool und liefert einen Risikobericht mit Noten und Durchsetzungsentscheidungen – alles in Sekunden.

Oder verwenden Sie die 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: meok-mcp-injection-scan-mcp

Beispiel-Snapshot (Forschungskohorte)

Das öffentliche ToolTrust-Verzeichnis enthält aktuelle Noten und aggregiert diese, während die Scans skaliert werden. Ein veröffentlichter Forschungsdurchlauf verdeutlicht die Form des Problems – 207 MCP-Server, 3.235 Tools – keine erschöpfende Zählung von allem, was wir heute scannen:

Nur 10 % der Server in dieser Kohorte hatten eine saubere Note A. Besuchen Sie tooltrust.dev für aktuelle, verzeichnisweite Ergebnisse (und verwenden Sie diese Tabelle nur als beschrifteten Snapshot).

Was es erkennt

ToolTrust führt 16 statische Analyseregeln gegen jede Tool-Definition in diesem Repo aus (AS-001–AS-011, AS-013–AS-017). AS-012 (Tool-Drift) wird im ToolTrust-Verzeichnis ausgewertet, wenn neue Scan-Ergebnisse mit früheren Durchläufen verglichen werden.

Vollständige Regeldetails: docs/RULES.md

Funktionsweise

1. Parsen – Verbindet sich mit einem Live-MCP-Server (oder liest eine JSON-Datei) und extrahiert jede Tool-Definition

2. Analysieren – Führt alle 16 Regeln gegen den Namen, die Beschreibung, das Schema und die Berechtigungen jedes Tools aus

3. Bewerten – Weist einen numerischen Risikowert und eine Note (A–F) pro Tool zu

4. Durchsetzen – Ordnet jede Note einer Gateway-Richtlinie zu: ALLOW, REQUIRE_APPROVAL oder BLOCK

Reine statische Analyse. Keine LLM-Aufrufe. Keine Daten verlassen Ihren Rechner (außer optionalen CVE-Abfragen). Läuft in Millisekunden. Deterministisch und reproduzierbar.

Installation

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

Wenn ToolTrust als MCP-Server ausgeführt wird, stellt es Ihrem Agent diese Tools zur Verfügung:

CI / GitHub Actions

Blockieren Sie riskante MCP-Server in Ihrer Pipeline:

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

Scan-vor-Installation-Gate

Fügen Sie nie wieder einen nicht vertrauenswürdigen MCP-Server zu Ihrer Konfiguration hinzu:

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

Vollständige Gate-Optionen und Einrichtung von Pre-Commit-Hooks: docs/USAGE.md

Fügen Sie Ihrem Projekt ein Vertrauenssiegel hinzu

Wenn Ihr MCP-Server ToolTrust besteht, lassen Sie es die Leute wissen:

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

Lieferketten-Warnung: ToolTrust erkennt und blockiert bestätigte kompromittierte Pakete, einschließlich LiteLLM v1.82.7/8 (TeamPCP-Backdoor), Trivy v0.69.4–v0.69.6 und Langflow < 1.9.0. Wenn Sie bei Regel AS-008 eine Note F erhalten, entfernen Sie das Paket sofort und rotieren Sie alle Anmeldeinformationen.

Nutzungsanleitung · Entwicklerhandbuch · Mitwirken · Bereitstellung & Sicherheit · Changelog · Sicherheit · Lizenz: MIT