Photoshop MCP Server, publié par loonghao, relie des assistants IA à Adobe Photoshop via photoshop-python-api et le Model Context Protocol. Le dépôt loonghao/photoshop-python-api-mcp-server le présente comme un pont pour créer, ouvrir et enregistrer des documents Photoshop, manipuler des calques, lire l'état de session et appliquer effets ou réglages. Lors de la vérification GitHub du 26 août 2026, le dépôt était sous licence MIT, comptait 299 étoiles et 27 forks, et pyproject.toml indiquait photoshop-mcp-server 0.1.11 avec Python >=3.10,<3.15.
Pour Educasium, Photoshop MCP doit être traité comme un outil d'automatisation locale, pas comme un générateur d'image. Sa contrainte la plus importante est explicite dans le README : Windows only. Le serveur dépend des interfaces COM Windows pour communiquer avec Photoshop, et macOS ou Linux ne sont pas supportés.
Sommaire
- Ce que fait Photoshop MCP
- Prérequis Windows, Photoshop et Python
- Configuration MCP et cycle de vie client
- Ressources et outils disponibles
- Sécurité, fichiers et limites
- Comparaison avec ComfyUI MCP
- Position Educasium
Ce que fait Photoshop MCP
À retenir : Photoshop MCP automatise Photoshop installé localement sur Windows via COM, au lieu de manipuler un fichier image de manière isolée. L'assistant agit dans une application graphique réelle, avec documents et calques.
Fonctions principales
Le README indique que le serveur peut créer, ouvrir et sauvegarder des documents Photoshop, créer et manipuler des calques de texte ou de couleur unie, récupérer des informations sur la session Photoshop, les documents actifs, la sélection, et appliquer des effets ou ajustements.
Cette surface convient aux tâches répétitives : préparer un document, ajouter un texte, inspecter le nombre de calques, créer une composition simple, appliquer un réglage ou sauvegarder une version. Elle est moins adaptée à la génération créative pure, qui relève plutôt de ComfyUI MCP ou d'un outil d'image générative.
Ce que cela implique
Le serveur pilote Photoshop, donc l'état de l'application compte. Document actif, calque sélectionné, version Photoshop, permissions fichiers et chemin de sauvegarde peuvent modifier le résultat. Un assistant qui dit avoir créé un calque doit être contrôlé dans Photoshop ou via les ressources exposées.
Le réflexe Educasium est simple : vérifier l'état de session avant et après chaque action. Dans les outils Adobe, l'automatisation peut être juste techniquement mais produire une planche visuelle médiocre.
Prérequis Windows, Photoshop et Python
À retenir : le README dit clairement que le projet fonctionne uniquement sous Windows à cause des interfaces COM. Photoshop doit être installé localement.
Système et logiciel
Les requirements indiquent Windows OS only, Adobe Photoshop installé localement et Python 3.10 ou plus. Le README mentionne des tests avec Photoshop CC2017 à 2024. pyproject.toml précise Python >=3.10,<3.15, mcp ^1.6.0, photoshop-python-api ^0.24.0, loguru et tenacity.
Cette contrainte exclut beaucoup d'environnements d'agence ou d'école qui travaillent sur macOS. Pour ces machines, il ne faut pas promettre un contournement simple. Un poste Windows avec Photoshop installé est le contexte cible.
Version Photoshop
La variable PS_VERSION indique au serveur quelle version de Photoshop viser, par exemple 2024, 2023 ou 2022. Cette variable est un détail pratique important : si plusieurs versions coexistent ou si la version déclarée ne correspond pas à l'installation, le pont peut échouer.
Une intégration sérieuse documente Windows, Python, version Photoshop, version du paquet, client MCP et fichier de configuration utilisé. Ce journal évite de confondre erreur de modèle et erreur d'environnement.
Configuration MCP et cycle de vie client
À retenir : la configuration recommandée utilise uvx avec photoshop-mcp-server et PS_VERSION. Le cycle de vie dépend de Photoshop local et du client MCP.
Configuration standard
Le README donne une configuration MCP avec command uvx, args --python 3.10 photoshop-mcp-server et env PS_VERSION. Il indique que ce format fonctionne avec Claude Desktop, Windsurf, Cline et d'autres hôtes MCP.
L'installation peut se faire avec pip install photoshop-mcp-server ou via uv. Le script console défini dans pyproject.toml est photoshop-mcp-server, pointant vers photoshop_mcp_server.server:main.
Cycle de vie applicatif
Le client MCP lance le serveur, le serveur utilise Python, Python appelle photoshop-python-api, puis Photoshop répond via COM. Si Photoshop est fermé, bloqué par une boîte de dialogue, ou si COM ne trouve pas la bonne version, l'assistant peut échouer même si la configuration MCP semble correcte.
Le premier test doit rester simple : demander les informations Photoshop, créer un document minimal, ajouter un calque texte, lire la liste des calques, puis sauvegarder dans un dossier de test. Les documents clients ne viennent qu'après ce contrôle.
Ressources et outils disponibles
À retenir : le README expose trois ressources et des familles d'outils pour documents, calques et session. La surface est plus modeste que ComfyUI MCP, mais mieux ciblée sur Photoshop.
Ressources
Les ressources documentées sont photoshop://info pour les informations de l'application, photoshop://document/info pour le document actif et photoshop://document/layers pour les calques. Ces ressources sont utiles avant d'agir, car elles donnent un état de départ.
Dans un workflow prudent, l'assistant lit d'abord les ressources, confirme le document actif et liste les calques. Ensuite seulement il crée ou modifie. Cette séquence réduit les erreurs liées au mauvais document ou calque.
Outils
Le README regroupe les outils en Document Tools, Layer Tools et Session Tools. Les exemples montrent la création d'un document, l'ajout d'un calque texte Hello World, l'ouverture d'un PSD et le comptage des calques, ou la création d'un post social avec fond dégradé et texte.
Ces exemples sont utiles, mais ils restent pédagogiques. Un post social professionnel demande typographie, marque, export, dimensions, marges, contraste et relecture. Le MCP peut automatiser la structure ; il ne garantit pas le goût.
Sécurité, fichiers et limites
À retenir : Photoshop MCP peut ouvrir et enregistrer des fichiers locaux, donc les chemins et copies sont centraux. Le risque principal est d'altérer un PSD de travail sans contrôle.
Fichiers et documents
Créer, ouvrir et sauvegarder des documents est une capacité puissante. Elle peut écraser des fichiers si le workflow est mal défini. Il faut donc utiliser un dossier de sortie dédié, nommer les versions et travailler sur des copies avant d'agir sur un fichier client.
Le serveur lit l'état Photoshop mais ne remplace pas l'inspection visuelle. Les calques peuvent exister et rester mal placés, mal nommés ou incohérents avec la charte. Un contrôle visuel reste obligatoire.
Limites de plateforme
La limite Windows only ne doit pas être minimisée. Les interfaces COM sont spécifiques à Windows. Pour macOS et Linux, un autre outil ou une autre chaîne est nécessaire. Pour des rendus génératifs ou workflows IA, ComfyUI MCP est plus portable.
Les versions Photoshop testées dans le README vont de CC2017 à 2024, mais une installation réelle peut avoir plugins, politiques IT, permissions ou fenêtres modales qui changent le comportement.
Comparaison avec ComfyUI MCP
À retenir : Photoshop MCP automatise une application Adobe locale ; ComfyUI MCP orchestre des graphes de génération IA.
| Besoin | Photoshop MCP | ComfyUI MCP |
|---|---|---|
| Ouvrir et sauvegarder PSD | Très adapté | Hors périmètre |
| Manipuler calques Photoshop | Très adapté | Hors périmètre |
| Générer images par modèles IA | Indirect | Très adapté |
| Fonctionner sur macOS/Linux | Non | Oui selon README |
| Contrôle créatif final | Photoshop local | Graphe ComfyUI et sorties |
Chaîne combinée
Un workflow cohérent peut générer des assets dans ComfyUI, puis les finaliser dans Photoshop. ComfyUI produit variantes, textures ou images de base. Photoshop assemble, retouche, ajoute texte, prépare export et respecte la charte.
Ce découpage évite de demander à Photoshop MCP de faire de la génération IA avancée et à ComfyUI MCP de gérer des documents PSD.
Position Educasium
À retenir : Educasium présente Photoshop MCP comme un outil d'automatisation de production graphique Windows, avec validation visuelle obligatoire.
Ce qu'il faut enseigner
Un exercice utile commence par un PSD de test. L'assistant lit les ressources, liste les calques, ajoute un texte, crée une couleur de fond, sauvegarde une copie, puis l'utilisateur vérifie dans Photoshop.
La compétence à apprendre est le contrôle de l'état : quel document est ouvert, quel calque est actif, quel fichier est sauvegardé, quelle version de Photoshop répond. Sans cette discipline, l'automatisation graphique devient fragile.
Le contrôle final inclut aussi la taille du document, le profil colorimétrique, les marges, la lisibilité du texte, le contraste, le nom des calques et le format d'export. Ces détails paraissent ordinaires, mais ce sont eux qui séparent une action Photoshop réussie d'un livrable réellement utilisable. Le serveur accélère la manipulation ; la validation reste visuelle et métier.