chatgpt-imagegen-mcp

Serveur MCP (stdio, Python ≥ 3.10, sans dépendance pour le serveur) qui génère des images depuis Claude Desktop, Codex ou tout client MCP, avec deux backends :

Aucune clé API OpenAI n'est nécessaire.

Chaîne d'appel (backend codex)

Client MCP ──stdio──► mcp_server.py ──► imagegen.py
        POST http://127.0.0.1:4202/v1/images/{generations|edits}
              (Bearer = jeton ChatGPT lu dans ~/.codex/auth.json)
                                 ▼
codex-router (127.0.0.1:4202) ── relaie ──► https://chatgpt.com/backend-api/codex/images/…
                                 ▼
                   { data: [ { b64_json } ] } ──► PNG local

Le routeur vérifie que le jeton présenté est celui de la session Codex puis relaie la requête.

Le backend francestudent lance node francestudent-mcp/src/server.mjs comme sous-processus et lui parle en MCP (francestudent_client.py).

Related MCP server: io.github.pvliesdonk/image-generation-mcp

Installation

git clone https://github.com/Yormede/chatgpt-imagegen-mcp
pip install -r requirements.txt        # Pillow, uniquement pour grid.py
# backend codex : Codex connecté (`codex login`) + codex-router lancé sur le port 4202
# backend francestudent : francestudent-mcp cloné à côté (ou FS_MCP_SERVER) et `npm run login` fait

Claude Desktop (claude_desktop_config.json) :

"imagegen": {
  "command": "python",
  "args": ["C:\\chemin\\vers\\chatgpt-imagegen-mcp\\mcp_server.py"]
}

Variables d'environnement

Outils MCP

Prompt prêt à coller dans les instructions d'un agent : AGENT_PROMPT.md.

CLI

python imagegen.py --health
python imagegen.py --prompt "Une pomme rouge sur fond blanc" --out pomme.png
python imagegen.py --prompt-file prompt.txt --ref a.jpg --ref b.jpg --out resultat.png
python quota.py                     # état du quota codex (state/)
python grid.py --prompt-file p.txt --cols 2 --rows 2 --name test --out-dir sorties   # planche N cases puis découpe

Limites mesurées (backend codex, novembre 2026)

• 5 images de référence maximum par appel (erreur 400 au-delà) ; 1 image de sortie par appel.

• size=auto : 1672×941 observé en 16:9, 1312×1199 en carré. Qualité low en génération simple, medium avec références. 16 s sans référence, 55–65 s avec 5 références.

• Quota image séparé du quota modèle Codex ; en-têtes x-codex-primary-used-percent, x-codex-primary-reset-at, x-codex-plan-type, enregistrés dans state/. Un dépassement renvoie 429 avec resets_at ; le client s'arrête sans réessayer.

• Modération à l'entrée et à la sortie (400 moderation_blocked), non déterministe : une nouvelle tentative identique peut passer.

Dépannage

Avertissement

Projet personnel non officiel, sans lien avec OpenAI ni France Student. Il utilise tes propres sessions (ChatGPT, France Student) pour un usage personnel : ne partage pas auth.json ni session.json, n'expose pas le port 4202, ne revends pas l'accès, et respecte les conditions d'utilisation de chaque service. Les quotas sont utilisés, pas contournés.

Licence

MIT