mcp-moncompte

Serveur MCP (Model Context Protocol) en lecture seule qui expose le catalogue de
notices de moncompte.org aux agents IA (Claude, etc.), déployé sur Cloudflare Workers.

• Stack : TypeScript + Cloudflare Workers + Durable Objects + SDK MCP officiel + Zod
• Source de données : endpoints publics du site statique moncompte.org (Astro / Cloudflare
  Pages) — pas de WP REST. La recherche et get_article lisent /search-index.json
  (index plein-texte généré au build : titre, slug, description, corps complet). La ressource
  about proxifie /llms.txt. Aucun secret requis.
• Cache : edge Cloudflare 1 h sur chaque appel

Dépendance : search_articles et get_article reposent sur https://moncompte.org/search-index.json,
produit par le site Astro (endpoint src/pages/search-index.json.js). Cet index exclut déjà
les articles datés dans le futur (isPublished) et les brouillons (draft) — le MCP ne voit donc
que le contenu réellement en ligne. L'index est régénéré à chaque build/déploiement du site.

Outils & ressource exposés

Type	Nom	Rôle
Outil	search_articles	Recherche par mots-clés (titre, slug, URL, extrait)
Outil	get_article	Contenu complet d'un article (par slug)
Ressource	moncompte://about	Proxy du llms.txt de moncompte.org

Endpoints

• /sse — Server-Sent Events (clients historiques)
• /mcp — Streamable HTTP (transport recommandé)
• Rate-limit : 100 req / 60 s par IP (binding natif Workers)
• Durable Object : NoticielMCP (classe McpAgent)

Développement

npm install
npm run dev          # wrangler dev (local)
npm run typecheck    # tsc --noEmit

Déploiement

npx wrangler login   # une fois (compte Cloudflare)
npm run deploy       # wrangler deploy

Le binding de rate-limit ([[unsafe.bindings]] type ratelimit) requiert Wrangler ≥ 4.36.
Le Durable Object McpAgent utilise le stockage SQLite (migration new_sqlite_classes).

Connecter un client MCP

• URL : https://mcp-moncompte.<ton-sous-domaine>.workers.dev/mcp (ou /sse)
• Claude Desktop / autres : via mcp-remote :

{
  "mcpServers": {
    "moncompte": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp-moncompte.<sous-domaine>.workers.dev/sse"]
    }
  }
}

Notes

• Aucune écriture : le serveur ne fait que lire l'API publique de moncompte.org.
• Les versions de agents et @modelcontextprotocol/sdk évoluent vite : en cas d'erreur de
  build, faire npm install agents@latest @modelcontextprotocol/sdk@latest.