io.github.waddou/mcp-moncompte
Recherche et lecture des guides de connexion de moncompte.org (MCP, lecture seule).
Open source Repository Open in the app JSON README (API)
About
Recherche et lecture des guides de connexion de moncompte.org (MCP, lecture seule).
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- waddou
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.1
- Last push
- 2026-08-13T10:01:30Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.waddou/mcp-moncompte
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
| 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
```bash
npm install
npm run dev # wrangler dev (local)
npm run typecheck # tsc --noEmit
```
## Déploiement
```bash
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` :
```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`.