foundry-vtt-mcp
Verified Safeby adambdooley
Overview
Connects Foundry VTT to Claude Desktop for AI-powered campaign management, character/compendium queries, content creation, and AI map generation.
Installation
node path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.jsEnvironment Variables
- LOG_LEVEL
- FOUNDRY_HOST
- FOUNDRY_PORT
- FOUNDRY_NAMESPACE
- MAP_GEN_HOST
- MAP_GEN_PORT
- MAP_GEN_ENABLED
- MAP_GEN_INSTALL_PATH
- MAP_GEN_PYTHON_PATH
- MAP_GEN_VENV_PATH
- MAP_GEN_WORKFLOW_PATH
Security Notes
The server architecture is designed with security in mind, employing a registry pattern and Zod schemas for input validation. Critical operations, such as character data extraction and content creation, are restricted to Game Master (GM) users in Foundry VTT, with additional configurable permissions for write operations ('Allow Write Operations' setting). The use of `execSync` and `spawn` for process execution is isolated to installation scripts (e.g., for Python/ComfyUI) and internal backend management (e.g., spawning the ComfyUI service), rather than processing arbitrary user input. No direct `eval` of user input is observed. Network communication uses WebSocket and WebRTC, typical for such applications. There are no obvious hardcoded API keys or sensitive credentials exposed. The biggest remaining risks would be a vulnerability in the underlying Foundry VTT API itself, or an undiscovered injection vector in the prompt processing that could bypass validation and lead to unintended system commands, though current code mitigates this by abstracting actions through specific tools. Requires user's Claude Pro/Max plan for MCP access, which implies an additional layer of external security.
Similar Servers
claude-memory-mcp
Provides local, persistent, and searchable memory for AI assistants like Claude Desktop, enabling them to store and recall information efficiently.
claude-code-buddy
An intelligent AI Agent orchestration system for Claude Code, focusing on smart task routing, prompt enhancement, project memory, workflow guidance, and planning, presented via a real-time terminal UI dashboard.
spec-oxide
A simple and lightweight Micro-Container Platform (MCP) designed for spec-driven development workflows.
miyabi-mcp-bundle
An all-in-one MCP server providing a vast array of development, monitoring, and automation tools, enabling Claude Desktop and AI agents to perform complex software development, operations, and analysis tasks efficiently and securely.