English Français العربية

Marcel

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

Calcul fiscal et retraite français, déterministe et sourcé. Aucun conseil.

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

التثبيت

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

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

التوثيق

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

المحتويات
  1. Marcel — serveur MCP
  2. Connexion
  3. Proxy local (stdio)
  4. Local proxy (stdio)
  5. Outils (11, tous en lecture seule)
  6. Limite d'appels
  7. Documentation
  8. Licence

Marcel — serveur MCP

Calcul fiscal et retraite français, déterministe et sourcé. Chaque résultat porte les règles appliquées (articles du CGI, du CSS), leur version et un traceId. Marcel mesure : il ne donne aucun conseil en investissement ni conseil fiscal.

French tax and retirement calculations for AI assistants. Deterministic, sourced, versioned. No financial advice.

Connexion

Serveur distant, sans clé, transport Streamable HTTP :

https://marcel-retraite.fr/mcp

Exemple de configuration (clients acceptant une URL distante) :

{
  "mcpServers": {
    "marcel": { "url": "https://marcel-retraite.fr/mcp" }
  }
}

Server card : https://marcel-retraite.fr/.well-known/mcp/server-card.json

Proxy local (stdio)

Ce dépôt est un proxy léger, sans calcul et sans secret. Au démarrage, un serveur MCP stdio se connecte en Streamable HTTP à l'endpoint distant (par défaut https://marcel-retraite.fr/mcp, remplaçable avec MARCEL_MCP_URL) et relaie tools/list et tools/call. Les prompts et les ressources sont relayés seulement si le serveur distant les expose. Les résultats sont informatifs, pas un conseil.

npx

Depuis GitHub, sans clone :

npx -y github:marcel-retraite/marcel-mcp

Exemple pour un client qui lance un processus :

{
  "mcpServers": {
    "marcel": {
      "command": "npx",
      "args": ["-y", "github:marcel-retraite/marcel-mcp"],
      "env": { "MARCEL_MCP_URL": "https://marcel-retraite.fr/mcp" }
    }
  }
}

Depuis une copie locale du dépôt :

npm install
npm run build
npx .

npm install lance aussi la compilation. node dist/index.js démarre le même serveur. La sortie standard est réservée au protocole MCP.

Docker
docker build -t marcel-mcp .
docker run -i --rm marcel-mcp

-i garde stdin ouvert. Pour viser un autre endpoint :

docker run -i --rm -e MARCEL_MCP_URL=https://marcel-retraite.fr/mcp marcel-mcp

Local proxy (stdio)

This repository is a thin proxy: no calculation logic and no secrets. On startup, a stdio MCP server connects with Streamable HTTP to the remote endpoint (default https://marcel-retraite.fr/mcp, override with MARCEL_MCP_URL) and forwards tools/list and tools/call. Prompts and resources are forwarded only when the remote server exposes them. Results are informative, not advice.

npx

From GitHub, without cloning:

npx -y github:marcel-retraite/marcel-mcp

Example for a client that spawns a process:

{
  "mcpServers": {
    "marcel": {
      "command": "npx",
      "args": ["-y", "github:marcel-retraite/marcel-mcp"],
      "env": { "MARCEL_MCP_URL": "https://marcel-retraite.fr/mcp" }
    }
  }
}

From a local checkout:

npm install
npm run build
npx .

npm install also builds. node dist/index.js starts the same server. Standard output is reserved for the MCP protocol.

Docker
docker build -t marcel-mcp .
docker run -i --rm marcel-mcp

-i keeps stdin open. To target another endpoint:

docker run -i --rm -e MARCEL_MCP_URL=https://marcel-retraite.fr/mcp marcel-mcp

Outils (11, tous en lecture seule)

OutilCe qu'il calcule
marcel_estimate_pensionPension de retraite brute ; net du foyer seulement si un RFR d'avis d'impôt est fourni
simulate_avFiscalité d'un contrat d'assurance-vie : rachat, avance, transmission (CGI 125-0 A, 990 I, 757 B)
simulate_peaFiscalité d'une sortie de PEA (CGI 157)
simulate_ctoFiscalité d'un compte-titres ordinaire personnel, une année (CGI 200 A, 158, 150-0 A et D)
simulate_per_sortieFiscalité d'une sortie de PER, en capital ou en rente
simulate_ifiIFI : assiette, barème, plafonnement (CGI 964 à 979)
simulate_dutreilTransmission d'entreprise : chemins avec et sans pacte Dutreil (CGI 787 B, 790)
acheter_louerAcheter ou louer sa résidence principale : écart de patrimoine dans le temps
simulate_cumulCumul emploi-retraite d'un salarié du régime général, règles avant et à partir de 2027
compare_resultsÉcart entre deux scénarios déjà calculés par Marcel
validate_resultsCohérence de plusieurs résultats Marcel entre eux

Règles en vigueur : LFSS 2026 (PFU 31,4 %, prélèvements sociaux 18,6 % ; assurance-vie à 17,2 %).

Limite d'appels

20 requêtes par minute et par adresse IP. Au-delà : HTTP 429, en-tête Retry-After, erreur JSON-RPC -32029. Détail : https://marcel-retraite.fr/developer#limites

Documentation

Licence

MIT pour le contenu de ce dépôt. Le service distant est fourni par Marcel ; ses résultats sont indicatifs et non contractuels.

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

ما هو Marcel؟

Calcul fiscal et retraite français, déterministe et sourcé. Aucun conseil.

كيف أثبّت Marcel؟

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

هل يحتاج Marcel إلى مفتاح API؟

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

هل Marcel مفتوح المصدر؟

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

من يصون Marcel؟

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

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