Packetrove mit einem KI-Agenten verbinden

Verbinde einen kompatiblen MCP-Client, um die Netzwerkwerkzeuge von Packetrove zu verwenden. Beginne mit der Einrichtung und nutze anschließend die Beispiele.

Streamable HTTP · Kein Konto oder API-Schlüssel erforderlich

https://api.packetrove.com/mcp

Ihren Client verbinden

Wenn Claude Code oder Codex installiert ist, fügen Sie diesen entfernten Server hinzu. Die Befehle konfigurieren den Client und installieren keinen lokalen Packetrove-Server.

Claude Code

claude mcp add --transport http --scope user packetrove \
  https://api.packetrove.com/mcp
MCP-Dokumentation für Claude Code

Codex

codex mcp add packetrove \
  --url https://api.packetrove.com/mcp
MCP-Dokumentation für Codex

Prüfe die Verbindung im Client mit /mcp. Diese Werkzeuge müssen verfügbar sein: cidr-cover, cidr-subtract, range-to-cidrs, certificate-bundle, public-ip.

Nach der Konfiguration entdeckt der Client Werkzeuge über tools/list. Beschreibungen und Schemas helfen bei Auswahl und Argumenten. Das Lesen einer Webseite konfiguriert keinen Client und gewährt keinen Werkzeugzugriff.

Serveridentität

Der Server stellt die folgende Dienstidentität mit seiner Veröffentlichungsversion bereit. Namen, Beschreibungen und Schemas einzelner Werkzeuge werden separat über tools/list aufgelistet.

{
  "name": "Packetrove",
  "title": "Packetrove",
  "description": "Open-source IP address and CIDR tools for network calculations and public IP lookup.",
  "websiteUrl": "https://packetrove.com",
  "icons": [
    {
      "src": "https://packetrove.com/packetrove-logo-32x32.png",
      "mimeType": "image/png",
      "sizes": [
        "32x32"
      ]
    }
  ],
  "version": "0.8.0"
}

Clients entscheiden, ob sie Titel, Beschreibung, Website oder Symbol anzeigen, und können optionale Felder ignorieren. Eine erfolgreiche Protokollerkennung belegt nicht, dass ein Client diese Informationen darstellt. Das PNG-Symbol ist 32×32 groß und hat keine Einschränkung auf ein Farbschema.

Optionales Agentenfeedback

submit-feedback ist eine optionale MCP-Supportoperation und standardmäßig deaktiviert. Nur verwenden, wenn tools/list sie anbietet. Sie sendet einen privaten Bericht per E-Mail zur manuellen Prüfung an den Maintainer; Website, Web API und CLI bieten keine Einreichung.

Nur auf Wunsch oder mit Zustimmung des Nutzers senden. Vorgelegte oder bereits genehmigte Berichte können direkt übermittelt werden. Neu formulierte Inhalte zuerst zur Genehmigung zeigen. Keine Gesprächsverläufe anhängen und nicht nach jedem Aufruf um Feedback bitten.

submit-feedback

category: bug, confusing_behavior oder feature_request. summary ist erforderlich; tool_name und synthetic_reproduction sind optional. Bugs benötigen expected und actual, unklares Verhalten actual. Featurewünsche erlauben expected, aber weder actual noch error_code. summary: 256 Unicode-Codepunkte; expected/actual: je 1024; Reproduktion: 2048. Ein optionaler error_code verwendet Großbuchstaben. Unbekannte Felder werden abgelehnt; serialisierte Argumente dürfen 8 KiB nicht überschreiten.

Beispielargumente

{
  "category": "confusing_behavior",
  "tool_name": "cidr-cover",
  "summary": "Explain why a covering CIDR can include additional addresses.",
  "actual": "The result includes addresses beyond the supplied documentation inputs.",
  "synthetic_reproduction": "Use documentation addresses 203.0.113.1 and 203.0.113.6."
}

Beispielergebnis mit Dokumentationsadressen

{
  "status": "accepted",
  "receipt_id": "00000000-0000-4000-8000-000000000001"
}

Die ungefähren Grenzen betragen 10 Einreichungen pro beobachteter Ausgangs-IP in den letzten 24 Stunden und 100 pro UTC-Kalendertag für den gesamten Dienst. Gemeinsame Ausgänge teilen das Kontingent. Gleichzeitige Anfragen und die KV-Synchronisierung können beide Grenzen überschreiten. Ungewisse Sendungen oder fehlgeschlagene Freigaben belegen das Kontingent bis zum Ablauf. Berechnungen und Abfragen bleiben unabhängig.

accepted und receipt_id bedeuten, dass der E-Mail-Dienst die Einreichung angenommen hat, nicht dass sie im Posteingang liegt oder gelesen wurde. Eine Antwort oder Korrektur wird nicht zugesagt. Bestätigte Ablehnungen enthalten delivery: not_accepted. Nach Zeitüberschreitung, Abbruch oder DELIVERY_UNCERTAIN nie automatisch erneut senden: Der Bericht kann bereits per E-Mail versandt sein. Es gibt keine Deduplizierung.

Wenn aktiviert, sendet submit-feedback den genehmigten Bericht, die Empfangsbestätigung, die öffentliche Dienstversion und die Einreichungszeit über Cloudflare per E-Mail an den Maintainer zur manuellen Prüfung. Nur künstliche Beispiele verwenden; keine echten Netzwerkdaten, Zertifikate, Geheimnisse, Protokolle oder Gesprächsverläufe. Aufbewahrung und Löschung im Postfach erfolgen manuell; Berichte verfallen nicht automatisch. Cloudflare Workers KV speichert getrennt nur schlüsselbasierte Ausgangs-IP-Marker und Reservierungszeiten, die nach 24 Stunden ablaufen, ohne Berichtsinhalte oder Verknüpfung zur Empfangsbestätigung. Marker erscheinen weder in Berichten noch in Logs. Das Löschen einer E-Mail gibt kein Kontingent zurück. Löschwünsche mit der Empfangsbestätigung per E-Mail an den Maintainer senden. Berichte werden nicht automatisch veröffentlicht.

Datenschutzerklärung

Ergebnisse lesen und Fehler behandeln

Lesen Sie structuredContent oder das JSON im Textblock. Behalten Sie Adressanzahlen als Dezimalzeichenfolgen oder Ganzzahlen beliebiger Genauigkeit; große IPv6-Anzahlen verlieren bei der Umwandlung in Gleitkommazahlen Genauigkeit.

Erfolgreiche Berechnungs- und Abfrageantworten behalten das Ergebnis in structuredContent und im ersten JSON-Textblock und ergänzen einen optionalen resource_link zur englischen Werkzeugseite. Links enthalten keine Eingaben oder Ergebnisse und stellen die Berechnung nicht wieder her. Clients entscheiden, ob sie Links anzeigen, ignorieren oder öffnen; automatische Darstellung oder Quellenangaben sind nicht garantiert. Die Public-IP-Seite prüft eine neue Browserverbindung, die von der MCP-Clientverbindung abweichen kann. Fehler enthalten keinen Werkzeugseiten-Link.

Wenn isError true ist, lesen Sie vor einem erneuten Versuch das Fehler-JSON. Korrigieren Sie INVALID_INPUT und MIXED_ADDRESS_FAMILIES anhand der Angaben des Nutzers. CLIENT_IP_UNAVAILABLE bedeutet, dass vertrauenswürdige Verbindungsmetadaten fehlen; erfinden Sie keine Adresse.

Fachliche Fehler verwenden das gemeinsame Fehler-JSON. Das MCP SDK prüft das Protokoll. Ungültiges JSON, nicht unterstützte Medientypen und zu große Anfragen werden auf HTTP-Ebene abgewiesen.

Ein Node.js-Beispiel ausführen

Speichere den folgenden Code in einem neuen Verzeichnis als packetrove-example.mjs und führe dann die Befehle aus. Das Beispiel verwendet @modelcontextprotocol/client@2.0.0, ermittelt Werkzeuge und ruft das CIDR-Werkzeug mit Dokumentationsadressen auf.

import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';

const client = new Client(
  { name: 'packetrove-example', version: "0.8.0" },
  { versionNegotiation: { mode: 'auto' } },
);
try {
  await client.connect(new StreamableHTTPClientTransport(new URL("https://api.packetrove.com/mcp")));
  const serverInfo = client.getServerVersion();
  const { tools } = await client.listTools();
  const result = await client.callTool({
    name: "cidr-cover",
    arguments: {"inputs":["203.0.113.1","203.0.113.2","203.0.113.6"]},
  });
  if (result.isError) throw new Error(JSON.stringify(result.content));
  console.log(serverInfo, tools.map(tool => tool.name), result.structuredContent);
  const links = result.content?.filter(content => content.type === 'resource_link') ?? [];
  console.log(links); // Optional links; opening or presenting them is the client's choice.
} finally {
  await client.close();
}
npm init -y
npm install @modelcontextprotocol/client@2.0.0
node packetrove-example.mjs

Starte für lokale Entwicklung pnpm dev:api und ersetze die Server-URL im Beispiel durch http://localhost:8787/mcp.

Bereitstellung und Verbindungsgrenzen

Der Server unterstützt moderne zustandslose Anfragen sowie Initialisierung, Erkennung und Aufrufe über älteres Streamable HTTP. Er bietet keine dauerhaften Sitzungen oder eigenständigen Server-Ereignisströme.

Die öffentliche IP wird für jede Werkzeuganfrage aus den Verbindungsmetadaten gelesen. Gleichzeitige Clients verwenden getrennte Serverinstanzen. MCP-Ergebnisse und Fehler nutzen Cache-Control: no-store, no-transform. Die Anwendung speichert oder protokolliert keine abgefragten Adressen.

Wir zählen Werkzeugausführungen mit Betriebsereignissen, die Werkzeugname, Erfolg oder Fehler, einen kontrollierten Fehlercode und eine Klassifizierung der Aufrufquelle enthalten. Verifizierte automatische Prüfungen können außerdem eine Automatisierungslaufkennung erfassen. Eingaben, Ergebnisse, ermittelte Adressen, unverarbeitete Anfrage-Header und Automatisierungstoken sind ausgeschlossen. Cloudflare kann Anfrage-Metadaten ergänzen; Verarbeitung und Aufbewahrung sind in der Datenschutzerklärung beschrieben.

Frühere Werkzeugnamen haben keine Kompatibilitätsaliase: smallest_covering_cidr → cidr-cover, subtract_cidrs → cidr-subtract, get_public_ip → public-ip. Aktualisiere die Werkzeugerkennung und gespeicherte Aufrufe.

Der Website-Pfad /mcp ist kein Dienstendpunkt: GET liefert 404 und POST 405, ohne Werkzeugaufrufe weiterzuleiten. Konfiguriere Clients mit https://api.packetrove.com/mcp. Passe bei eigener Bereitstellung Domains sowie die getrennten exakten Host- und Browser-Origin-Freigaben an. Clients ohne Origin-Header werden unterstützt.

Bereitstellung, Selbsthosting und ProduktionsprüfungDatenschutzerklärungVeröffentlichung in der MCP Registry und VersionsregelnDie technische MCP-Anleitung im Repository lesen (Englisch)