Un servidor de Model Context Protocol para generación de imágenes específico para Foundry, para arte de mesa de D&D, impulsado por Claude Code. Envuelve una instancia headless de ComfyUI en la máquina local y expone un pequeño conjunto de herramientas orientadas a Foundry para que Claude pueda redactar prompts, generar lotes de ilustraciones, curar los resultados mirándolos de verdad y entregar los ganadores al pipeline de Foundry en su servidor hermano, fvtt-mcp-molten5e (upload-asset → set-actor-art / add-journal-image / fondos de escena).
El ciclo completo es lo bastante rápido como para ser conversacional en el hardware objetivo (RTX 5090): un lote de borradores de 6 imágenes se genera en ~10 s, un render terminado de 2560×1600 en ~19 s, y el ciclo completo prompt → borrador → curar → final → diario en el mundo se probó de extremo a extremo en notes/m3-loop-proof.md.
Esto no es un puente genérico de ComfyUI, por decreto. Las herramientas hablan el vocabulario de Foundry — retratos de actor, tokens, handouts, fondos de escena — y se ajustan libremente para el trabajo con Foundry. Y se mantiene separado de fvtt-mcp-molten5e: ese servidor está limitado a la creación de contenido de Foundry y no debe acoplarse a la generación de imágenes. Este servidor nunca habla con el puente de Foundry; el traspaso entre ambos son archivos en disco más las herramientas de subida de molten5e.
La misma filosofía de casa que el resto de la familia: las herramientas hacen, las skills deciden. La corrección (ejecución del workflow, dimensiones, el pipeline de upscaling, convenciones de archivos) reside en las herramientas probadas; el criterio (elaboración del prompt, gusto de curación, qué actor o diario recibe el arte, estilo de casa) reside en una skill posterior illustration-builder.
Claude ──MCP──> fvtt-mcp-artificer ──HTTP──> ComfyUI (headless, local)
│
└── pinned workflow JSONs (draft / final / final-refine / upscale)ComfyUI se ejecuta headless en modo API; este servidor envía los workflow JSON fijados que están en workflows/ — nunca grafos de forma libre — con prompt/seed/batch/preset sustituidos (por ID de nodo, protegido por aserciones de deriva de tipo de clase). Las herramientas devuelven rutas de archivo absolutas; Claude lee los PNG directamente para curar.
Related MCP server: FoundryVTT MCP Server
generate-image recibe un kind, no ancho/alto:
kind | genera a | salida final |
| 1536×960 | 2560×1600 |
| 1024×1280 | 2048×2560 |
| 1024×1024 | 2048×2048 |
Pipeline de resolución (fijado): nunca generar al tamaño de salida — la composición se degrada más allá de ~1.5 MP. Genera a la resolución nativa del preset, upscaling por modelo ×4 con 4x-UltraSharp, downsampling lanczos al tamaño final, todo en un único grafo fijado.
FLUX.1-dev fp8 (Comfy-Org all-in-one) — renders de calidad final, ~15–19 s por render terminado.
FLUX.2-klein 4B (Apache 2.0) — el modelo de borradores: 4 pasos, ~1–2 s/imagen, lote de 6–8, elige y vuelve a renderizar con dev.
4x-UltraSharp — el upscaler de modelo en la cola del pipeline.
herramienta | qué hace |
|
|
| Termina una imagen existente (normalmente un borrador que ganó la curación directamente) a través de la cola de upscaling hasta la resolución de salida de su |
| Comprobación de salud: accesibilidad/versión de ComfyUI, VRAM, profundidad de la cola, integridad de los workflow fijados, presencia de los modelos requeridos. |
El contrato de sustitución entre las herramientas y los grafos fijados está documentado en workflows/README.md.
Windows + GPU NVIDIA. Desarrollado y probado en una RTX 5090 (Blackwell necesita PyTorch con CUDA 12.8+; la compilación portable actual de ComfyUI lo incluye).
ComfyUI (compilación portable independiente, v0.34+) ejecutándose headless — consulta scripts/launch-comfyui.ps1 para la convención de lanzamiento (modo API en 127.0.0.1:8188, con --output-directory fijado).
Los archivos de modelo en el árbol models/ de ComfyUI (~33 GB, todos sin restricciones de acceso): checkpoints/flux1-dev-fp8.safetensors, diffusion_models/flux-2-klein-4b.safetensors, text_encoders/qwen_3_4b.safetensors, vae/flux2-vae.safetensors, upscale_models/4x-UltraSharp.safetensors. artificer-status informa de cualquier modelo que falte.
Node.js 22+ para el propio servidor MCP.
npm install
npm run buildPruebas: npm test (suite de pruebas unitarias sin conexión; los workflow JSON fijados son los fixtures). La suite en vivo — ComfyUI real, renders reales — está detrás de npm run test:integration. Puertas de calidad: npm run typecheck, npm run check (biome), npm run knip.
La convención de la casa registra el servidor en el alcance de usuario (nuevas herramientas MCP ⇒ reinicia Claude Code). O usa la CLI:
claude mcp add -s user artificer -- node D:/path/to/fvtt-mcp-artificer/dist/index.jso copia .mcp.json.example a un .mcp.json que Claude Code lea (o combínalo en mcpServers de ~/.claude.json) con rutas absolutas. En Windows, apunta command a la ruta completa de node.exe si Node no está en PATH.
Copia .env.example a .env (ignorado por git):
COMFY_URL — la instancia headless (por defecto http://127.0.0.1:8188).
COMFY_OUTPUT_DIR — debe coincidir con el --output-directory con el que se lanzó ComfyUI; el servidor lee los PNG generados directamente de esta ruta.
ARTIFICER_TIMEOUT_MS — límite de espera por trabajo (por defecto 300000).
Licencia MIT — consulta LICENSE para más detalles.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Manage TTRPG campaigns: NPCs, locations, factions, quests, sessions, lore, and knowledge graphs.
Generate logos, social posts, app screenshots, comic panels & visual-novel assets from prompts.
Design, save, and run outcome-aligned AI workflows and verifiers, with reliable image output.
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Txpple/fvtt-mcp-artificer'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
