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

Terminal

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

Déploiement

Terminal

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 :

config.json

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