Connecter Packetrove à un agent IA

Connectez un client MCP compatible pour utiliser les outils réseau Packetrove. Commencez par la configuration ci-dessous, puis consultez les exemples.

Streamable HTTP · Aucun compte ni clé API nécessaire

https://api.packetrove.com/mcp

Connecter votre client

Avec Claude Code ou Codex installé, ajoutez ce serveur distant. Ces commandes configurent le client ; elles n’installent pas de serveur Packetrove local.

Claude Code

claude mcp add --transport http --scope user packetrove \
  https://api.packetrove.com/mcp
Documentation MCP de Claude Code

Codex

codex mcp add packetrove \
  --url https://api.packetrove.com/mcp
Documentation MCP de Codex

Utilisez /mcp dans votre client pour vérifier la connexion. Confirmez la disponibilité de ces outils : cidr-cover, cidr-subtract, range-to-cidrs, certificate-bundle, public-ip.

Après configuration, le client découvre les outils avec tools/list. Les descriptions et les schémas guident le choix et les arguments. Lire une page web ne configure pas un client et ne lui donne pas accès aux outils.

Identité du serveur

Le serveur fournit l’identité de service suivante, avec sa version publiée. Les noms, descriptions et schémas de chaque outil sont répertoriés séparément via tools/list.

{
  "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"
}

Les clients décident d’afficher ou non le titre, la description, le site web ou l’icône et peuvent ignorer les champs facultatifs. Une découverte réussie du protocole ne prouve pas qu’un client affiche ces informations. L’icône PNG mesure 32×32 et n’a aucune restriction de thème.

Retours facultatifs des agents

submit-feedback est une opération de support MCP facultative, désactivée par défaut. Utilisez-la seulement si tools/list la propose. Elle envoie un rapport privé par e-mail au responsable pour examen humain ; aucun envoi depuis le site, la Web API ou la CLI.

Envoyez uniquement à la demande de l’utilisateur ou avec son accord. Un rapport fourni ou déjà approuvé peut être envoyé directement. Présentez tout nouveau texte pour approbation. Ne joignez pas l’historique des conversations et ne sollicitez pas un retour après chaque appel.

submit-feedback

category : bug, confusing_behavior ou feature_request. summary est requis ; tool_name et synthetic_reproduction sont facultatifs. Un bug exige expected et actual ; un comportement confus, actual. Une demande de fonctionnalité accepte expected, mais pas actual ni error_code. summary : 256 points de code Unicode ; expected/actual : 1024 chacun ; reproduction : 2048. error_code facultatif utilise des majuscules. Champs inconnus refusés ; arguments sérialisés limités à 8 KiB.

Exemple d’arguments

{
  "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."
}

Exemple de résultat avec des adresses de documentation

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

Les limites approximatives sont de 10 envois par IP de sortie observée sur les dernières 24 heures et de 100 par jour UTC pour tout le service. Les sorties partagées partagent leur quota. Les requêtes simultanées et la propagation KV peuvent dépasser ces limites. Les envois incertains ou les libérations de quota échouées occupent le quota jusqu’à expiration. Les calculs et recherches restent indépendants.

accepted et receipt_id indiquent que le service e-mail a accepté l’envoi, sans garantir son arrivée dans la boîte de réception ni sa lecture. Aucune réponse ou correction n’est promise. Un refus confirmé renvoie delivery: not_accepted. Ne renvoyez jamais automatiquement après un délai dépassé, une annulation ou DELIVERY_UNCERTAIN : le rapport peut déjà avoir été envoyé par e-mail. Il n’y a pas de déduplication.

Lorsqu’il est activé, submit-feedback transmet le rapport autorisé, le reçu, la version publique du service et l’heure d’envoi par e-mail via Cloudflare au responsable pour examen humain. Utilisez des exemples fictifs ; excluez données réseau réelles, certificats, secrets, journaux et historique de conversation. La conservation et la suppression dans la boîte mail sont gérées manuellement ; les rapports n’expirent pas automatiquement. Cloudflare Workers KV conserve séparément uniquement des marqueurs d’IP de sortie dérivés avec une clé et les heures de réservation, expirant après 24 heures, sans contenu du rapport ni lien avec le reçu. Les marqueurs ne figurent ni dans les rapports ni dans les journaux. Supprimer un e-mail ne restitue pas le quota. Demandez la suppression par e-mail au responsable avec votre reçu. Les rapports ne sont pas publiés automatiquement.

Politique de confidentialité

Lire les résultats et traiter les erreurs

Lisez structuredContent ou le JSON du bloc de texte. Conservez les nombres d’adresses sous forme de chaînes décimales ou d’entiers de précision arbitraire ; convertir de grands comptes IPv6 en nombres à virgule flottante perd de la précision.

Les réponses réussies des calculs et recherches conservent le résultat dans structuredContent et dans le premier bloc de texte JSON, puis ajoutent un resource_link facultatif vers la page anglaise de l’outil. Les liens ne contiennent ni entrées ni résultats et ne restaurent pas le calcul. Chaque client décide d’afficher, d’ignorer ou d’ouvrir les liens ; leur affichage ou citation automatique n’est pas garanti. Ouvrir la page d’IP publique vérifie une nouvelle connexion du navigateur, qui peut différer de celle du client MCP. Les erreurs ne comportent pas de lien vers l’outil.

Si isError vaut true, lisez le JSON d’erreur avant de réessayer. Corrigez INVALID_INPUT et MIXED_ADDRESS_FAMILIES à partir des informations de l’utilisateur. CLIENT_IP_UNAVAILABLE indique l’absence de métadonnées de connexion fiables ; n’inventez pas d’adresse.

Les erreurs métier utilisent le JSON d’erreur partagé. Le SDK MCP valide le protocole. Les données JSON invalides, les types de contenu non pris en charge et les corps trop volumineux sont rejetés au niveau HTTP.

Exécuter un exemple Node.js

Dans un nouveau dossier, enregistre le code dans packetrove-example.mjs, puis exécute les commandes. L’exemple utilise @modelcontextprotocol/client@2.0.0, découvre les outils et appelle l’outil CIDR avec des adresses de documentation.

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

Pour le développement local, lance pnpm dev:api et remplace l’URL du serveur par http://localhost:8787/mcp.

Déploiement et limites de connexion

Le serveur accepte les requêtes modernes sans état ainsi que l’initialisation, la découverte et les appels de l’ancien transport Streamable HTTP. Il ne fournit ni sessions persistantes ni flux d’événements serveur autonomes.

Les métadonnées de l’IP publique sont lues pour chaque appel, avec des instances isolées entre clients simultanés. Les résultats et erreurs MCP utilisent Cache-Control: no-store, no-transform. L’application ne conserve ni ne journalise les adresses consultées.

Nous comptons les exécutions avec des événements opérationnels contenant le nom de l’outil, le succès ou l’erreur, un code d’erreur contrôlé et une classification de l’origine de l’appel. Les vérifications automatisées validées peuvent aussi enregistrer un identifiant d’exécution d’automatisation. Les entrées, résultats, adresses consultées, en-têtes de requête bruts et jetons d’automatisation sont exclus. Cloudflare peut ajouter des métadonnées ; consultez la politique de confidentialité pour le traitement et la conservation.

Les anciens noms n’ont pas d’alias de compatibilité : smallest_covering_cidr → cidr-cover, subtract_cidrs → cidr-subtract, get_public_ip → public-ip. Actualise la découverte des outils et les appels enregistrés.

Le chemin /mcp du site n’est pas le service : GET renvoie 404 et POST 405, sans proxy ni redirection des appels. Configure les clients avec https://api.packetrove.com/mcp. Pour ton déploiement, adapte les domaines et les listes exactes distinctes de Host et d’Origin du navigateur ; les clients sans en-tête Origin sont acceptés.

Déploiement, auto-hébergement et vérification en productionPolitique de confidentialitéPublication dans MCP Registry et politique de versionsLire le guide technique MCP du dépôt (en anglais)