Foundry MCP

Serveur MCP et module pont pour piloter Foundry VTT 14 depuis Codex CLI ou un autre client MCP. Le pont s'exécute dans le navigateur d'un GM et utilise les API publiques de Foundry, ainsi qu'un adaptateur Plutonium optionnel.

Les règles de travail apprises au fil des corrections sont maintenues dans agent_rules.md. Leur contenu complet est transmis à tout nouveau client MCP et reste consultable via foundry://agent-rules ou l’outil foundry_get_agent_rules.

Installation

Le module Foundry et le serveur MCP sont deux composants différents :

• le module s'installe depuis l'interface Foundry avec une URL de manifeste ;

• le module peut créer, après confirmation, un compte GM technique dédié ;

• le serveur MCP peut lancer et réauthentifier automatiquement un Chromium headless ;

• le serveur MCP est un service Node.js indépendant, déployé de préférence avec Docker ;

• Codex CLI se connecte ensuite au serveur MCP en HTTPS.

Les commandes complètes sont dans docs/installation.md. La construction npm du module n'est nécessaire que pour le développement ou pour produire une archive locale avant la publication d'une release GitHub. La procédure de publication est décrite dans docs/releasing.md.

Related MCP server: Foundry VTT MCP Server

Développement

Prérequis : Node.js 22 et npm.

npm install
npm run check
npm test
npm run build
npm run package:module

Le projet ne fixe aucun objectif de couverture. Les tests privilégient les parcours complets (client MCP, pont GM, opérations Foundry, Plutonium et confirmation des suppressions) ; les tests unitaires sont réservés aux contrats et garde-fous de sécurité.

Pour lancer les vérifications depuis une copie de développement :

git clone https://github.com/Wameuh/Foundry-MC-Server.git
cd Foundry-MC-Server
npm ci
npm run check
npm test
npm run build
npm run package:module

Ne jamais committer le fichier .env.

La documentation d'installation et de configuration détaillée se trouve dans docs/.