Rezepte / MCP Tool-Manifest

MCP Tool-Manifest vor Agentenaufrufen prüfen

Bevor ein Energie-Agent ein Tool aufruft, sollte sichtbar sein, wofür das Tool gedacht ist, welche Eingaben erlaubt sind und wann bewusst kein Aufruf stattfinden darf. Dieses Rezept modelliert diese Grenze als kleines JavaScript-Dry-Run.

Suchintention

MCP Tool Manifest Energie JavaScript: Teams möchten Agenten nicht blind mit Fachtools verbinden, sondern Zweck, Datenklasse und No-Call-Regeln vor dem ersten Aufruf prüfen.

Public-safe Evidenz

Cernion beschreibt öffentliche REST/MCP-Integrationen und kontrollierte API-Token als Einstieg. Für eine Praxisbibliothek reicht ein synthetisches Manifest, das keine echten Systeme oder Zugangsdaten enthält.

CTA

Wenn aus dem Manifest ein geprüfter Integrationspfad werden soll: Felix Mertens kann die Grenze zwischen Demo, Test-Token und produktiver Fachintegration einordnen.

Prinzip

Das Beispiel ruft kein Tool auf. Es prüft nur, ob ein synthetischer Request zum erlaubten Zweck, zur Datenklasse und zu den No-Call-Regeln des Manifests passt.

node examples/mcp-tool-manifest-dry-run.js

Minimalbeispiel

const manifest = {
  tool: "synthetic.grid.asset.lookup",
  purpose: "read_only_asset_context",
  allowedData: ["synthetic", "anonymized"],
  noCallIf: ["contains_personal_data", "asks_for_binding_decision"]
};

const request = {
  purpose: "read_only_asset_context",
  dataClass: "synthetic",
  flags: ["demo"]
};

const allowed = manifest.purpose === request.purpose
  && manifest.allowedData.includes(request.dataClass)
  && !request.flags.some((flag) => manifest.noCallIf.includes(flag));

console.log({ allowed });

Warum das nützlich ist

  • Tool-Grenzen vor Tool-Aufruf: Der Dry-Run dokumentiert, wann ein Agent bewusst nicht weitergeht.
  • Public-safe: Manifest und Request sind synthetisch; es gibt keine Tokens, Kundendaten oder Systemverbindungen.
  • Auditierbar: Der Output erklärt Grund, Status und nächsten sicheren Schritt statt nur true/false.

Dieses Rezept ist technische Orientierung mit synthetischen Daten. Es ist keine Freigabe für produktive Systemanbindungen, keine Rechts- oder Prozesszusage und ersetzt keine fachliche Prüfung.

Beispielskript ansehen