English Français العربية

io.github.waddou/mcp-moncompte

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.waddou/mcp-moncompte؟

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

كيف أثبّت io.github.waddou/mcp-moncompte؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http mcp-moncompte 'https://mcp-moncompte.wadie.workers.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.waddou/mcp-moncompte إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.waddou/mcp-moncompte مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.waddou/mcp-moncompte؟

ينشره waddou. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.