Zum Inhalt springen

Zurück zu Guardrino

Integration · Verfügbar

Der MCP-Sicherheitsproxy

Er sitzt zwischen einem Agenten und seinen MCP-Servern und prüft, was die Tools sagen, was der Agent ihnen sendet und was sie zurückgeben.

Status: Verfügbar. Diese Integration ist gebaut und getestet. HisnLabs liefert Guardrino an Pilotunternehmen; einzelne Einstellungen können sich vor der allgemeinen Veröffentlichung noch ändern.

Developer reference · Install guide · AI platforms · Open model card · OpenAI-kompatibler Proxy · Streaming · LiteLLM · Anleitung: OpenAI-kompatible App · Anleitung: LiteLLM · Anleitung: MCP-Tools

Try it today Guardrino-t7 Open, an earlier version of our classifier, is public on Hugging Face under Apache-2.0. The demo runs in your browser: what you type stays on your device. Live demo · Model card · Same demo on Hugging Face

Was geprüft wird

ZeitpunktPrüfung
Tools werden aufgelistetDie Tool-Beschreibungen werden geprüft, da ein Agent sie wie Anweisungen liest.
Ein Aufruf geht hinausDie Argumente werden geprüft: Canary-Token, personenbezogene Daten und URLs.
Ein Ergebnis kommt zurückDas Ergebnis wird als Kontext in Fenstern geprüft, damit auch lange Ausgaben vollständig gelesen werden.

Ein Ergebnis wird wie jedes Dokument beurteilt, das das Modell als Daten liest. Dieselbe Prüfung können Sie von Hand über die Inspect-API ausprobieren, mit direction auf context.

POST /v1/inspect HTTP/1.1
Content-Type: application/json

{
  "text": "<tool result text>",
  "direction": "context",
  "app": "support-agent",
  "conversation_id": "conversation-7f3a"
}

Transporte

Der Proxy spricht den Streamable-HTTP-Transport von MCP (eine Route je Server, /mcp/{name}) und für lokale Server stdio.

Konfiguration

Nennen Sie die MCP-Server, vor denen der Proxy sitzt. Er bleibt aus, bis servers gesetzt ist, und jeder Server erhält eine eigene Route.

[mcp]
on_tool_poisoning = "drop"   # "drop": remove a flagged tool from the list | "refuse": refuse the whole list
timeout_secs = 120
servers = [
  { name = "files", url = "https://mcp.example/mcp", headers = { Authorization = "Bearer UPSTREAM_TOKEN" } },
]

Richten Sie Ihren Agenten auf den Proxy statt auf den MCP-Server.

{
  "mcpServers": {
    "files": { "url": "https://guardrino.example/mcp/files" }
  }
}

Für einen lokalen stdio-Server starten Sie guardrino-mcp-stdio --server-cmd "<command>" anstelle des Servers in der Konfiguration des Agenten. Es führt den Befehl aus und prüft jede Nachricht in beide Richtungen auf dieselbe Weise; ein servers-Eintrag ist nicht nötig.

{
  "mcpServers": {
    "files": { "command": "guardrino-mcp-stdio", "args": ["--server-cmd", "npx some-mcp-server"] }
  }
}

Ein abgelehnter Aufruf erhält einen JSON-RPC-Fehler (Code -32000, data.code content_blocked). Ein markiertes Tool wird aus der Liste entfernt oder die ganze Liste abgelehnt, je nach on_tool_poisoning. Noch nicht abgedeckt: Vom Server ausgehende Anfragen und Benachrichtigungen (etwa Sampling) werden nicht geprüft, und JSON-RPC-Batches werden abgelehnt.

MCP-Tools schützen: Installationsanleitung

Frühzugang anfragen