English Français العربية

io.github.waddou/mcp-moncompte

Official registry Other

Recherche et lecture des guides de connexion de moncompte.org (MCP, lecture seule).

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mcp-moncompte 'https://mcp-moncompte.wadie.workers.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-moncompte": {
            "type": "http",
            "url": "https://mcp-moncompte.wadie.workers.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-moncompte
  2. Outils & ressource exposés
  3. Endpoints
  4. Développement
  5. Déploiement
  6. Connecter un client MCP
  7. Notes

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

TypeNomRôle
Outilsearch_articlesRecherche par mots-clés (titre, slug, URL, extrait)
Outilget_articleContenu complet d'un article (par slug)
Ressourcemoncompte://aboutProxy 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.

Frequently asked questions

What is io.github.waddou/mcp-moncompte?

Recherche et lecture des guides de connexion de moncompte.org (MCP, lecture seule).

How do I install io.github.waddou/mcp-moncompte?

It runs as a remote server. In Claude Code: claude mcp add --transport http mcp-moncompte 'https://mcp-moncompte.wadie.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.waddou/mcp-moncompte need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.waddou/mcp-moncompte open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.waddou/mcp-moncompte?

It is published by waddou. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.