English Français العربية

io.github.waddou/mcp-compteparticulier

Registre officiel Autres

Guides de connexion aux espaces clients français de compteparticulier.com (MCP, lecture seule).

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mcp-compteparticulier 'https://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-compteparticulier": {
            "type": "http",
            "url": "https://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mcp-compteparticulier
  2. Endpoints
  3. Connexion depuis un client MCP
  4. Outils
  5. Ressource
  6. Fonctionnement
  7. Développement
  8. Stack
  9. Licence

mcp-compteparticulier

Serveur MCP (Model Context Protocol) en lecture seule qui expose le catalogue de compteparticulier.com aux agents IA : des guides pas-à-pas pour se connecter aux espaces clients de marques et administrations françaises — banques, assurances, mutuelles, énergie, télécom, streaming, services publics, commerce.

Endpoints

Le serveur est déjà déployé, sans authentification :

TransportURL
Streamable HTTPhttps://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp
SSEhttps://mcp-compteparticulier.ads-particulier-tn.workers.dev/sse

Connexion depuis un client MCP

{
  "mcpServers": {
    "compteparticulier": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp"]
    }
  }
}

Outils

search_articles

Recherche les guides par mots-clés, sur le titre, la marque, la description et le corps de l'article. Renvoie titre, slug, URL et description.

ParamètreType
querystringrequis — ex. « se connecter EDF »
limitnumberoptionnel, 1-20, défaut 10

Le classement privilégie la marque exactement demandée, puis le titre, puis la description, le corps ne servant que d'appoint. Sans cette pondération, une requête « EDF » remontait EDF ENR au même rang qu'EDF. La recherche est insensible aux accents : « caisse epargne » trouve « Caisse d'Épargne ».

get_article

Renvoie le contenu complet d'un guide à partir de son slug, obtenu via search_articles.

ParamètreType
slugstringrequis — ex. « mon-compte-edf »

Ressource

compteparticulier://about — le llms.txt du site (présentation et catalogue).

Fonctionnement

compteparticulier.com est un site statique (Astro / Cloudflare Pages) sans API. Le serveur lit donc deux ressources publiques, toutes deux générées au build :

  • /search-index.json — index plein texte : titre, slug, marque, catégorie, description, corps de l'article et questions-réponses ;
  • /llms.txt — catalogue lisible, servi comme ressource « about ».

Ces deux fichiers appliquent le même filtre de date que les pages du site. Un article programmé ou en brouillon en est absent, exactement comme sa page n'est pas générée : le serveur ne peut donc pas exposer un contenu qui n'est pas publié, ni renvoyer une URL en 404.

Aucun secret, aucune authentification, aucune donnée personnelle n'entre en jeu.

Développement

npm install
npm run typecheck   # tsc --noEmit
npm run dev         # wrangler dev
npm run deploy      # wrangler deploy

Les versions de dépendances sont figées et non exprimées en plages. agents requiert @cloudflare/workers-types en version 4, tandis que les versions récentes de wrangler en exigent la 5 : une plage ^ fait basculer l'installation dans ce conflit. Toute montée de version doit donc être vérifiée sur l'ensemble de l'arbre.

Stack

Cloudflare Workers + Durable Objects (session MCP) + SDK MCP officiel + Zod. Cache edge d'une heure, rate-limit de 100 requêtes par minute et par IP.

Licence

MIT

Questions fréquentes

Qu'est-ce que io.github.waddou/mcp-compteparticulier ?

Guides de connexion aux espaces clients français de compteparticulier.com (MCP, lecture seule).

Comment installer io.github.waddou/mcp-compteparticulier ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http mcp-compteparticulier 'https://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.waddou/mcp-compteparticulier ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.waddou/mcp-compteparticulier est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.waddou/mcp-compteparticulier ?

Il est publié par waddou. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.