MCP 服务器

cegid-mcp

Open-source MCP server that exposes Cegid APIs (accounting, third parties, documents, HR) as tools for LLM agents via the Model Context Protocol. Currently in early bootstrap phase with core structure in place.

README

cegid-mcp

Serveur MCP open source pour les API Cegid, maintenu par Nijal AI.

Objectif : exposer les ressources Cegid (comptabilité, tiers, pièces, RH selon le produit ciblé) sous forme d'outils MCP consommables par un agent LLM.

⚠️ Projet en amorçage — le squelette est en place, les outils métier restent à implémenter.

Stack

Python ≥ 3.11
mcp (FastMCP), httpx, pydantic-settings
Transport : stdio (HTTP/SSE à évaluer)

Démarrage

uv sync --extra dev
cp .env.example .env   # renseigner les credentials
uv run cegid-mcp

Test rapide avec l'inspecteur MCP :

npx @modelcontextprotocol/inspector uv run cegid-mcp

Configuration

Toutes les variables sont préfixées CEGID_ (voir .env.example). Auth : OAuth2 client_credentials sur le endpoint /token, puis Authorization: Bearer <token>. Certains produits Cegid exigent en plus une clé de souscription APIM.

Doc de référence : https://developers.cegid.com

Structure

src/cegid_mcp/
  config.py   # settings via env
  client.py   # client HTTP + OAuth2  (à implémenter)
  server.py   # déclaration des outils MCP
tests/

Roadmap (à affiner)

[ ] Auth OAuth2 : token, cache, refresh, gestion des erreurs
[ ] Choisir le périmètre v0 (quel produit Cegid : Expert / XRP Flex / Loop / Retail ?)
[ ] 3-4 outils en lecture seule sur ce périmètre
[ ] Outils en écriture + garde-fous (confirmation, dry-run)