mcpField
M
mcp-moncompte

mcp-moncompte

Remote
moncompte.orgSearch0Updated 11w ago
RepositoryVisit website

About mcp-moncompte

mcp-moncompte is a read-only MCP server that lets AI agents search and retrieve account-access guides from moncompte.org. It reads the site's public index and exposes only published content.

Key features

  1. 01Search guide titles and article text
  2. 02Retrieve full articles by slug
  3. 03Expose site overview as a resource
  4. 04Serve published content only
  5. 05Streamable HTTP and SSE endpoints

Use cases

  1. 01Find a guide for accessing an online account
  2. 02Read the complete instructions for a service
  3. 03Give an AI agent searchable moncompte.org content

MCP support

Exposes `search_articles` and `get_article` tools and the `moncompte://about` resource. MCP clients connect using the `/mcp` Streamable HTTP endpoint or `/sse`.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://mcp-moncompte.wadie.workers.dev/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.