Back to Home
darkbard81 icon

fvtt-mcp

Verified Safe

by darkbard81

Overview

Relays events and messages between a Large Language Model (LLM), an MCP server, and Foundry VTT, including features for AI-driven text-to-speech and image generation.

Installation

Run Command
podman run -d --name fvtt-mcp --env-file .env -p 3000:3000 ghcr.io/darkbard81/fvtt-mcp:latest

Environment Variables

  • MCP_SERVER_API_KEY
  • GOOGLE_GENAI_API_KEY
  • GITHUB_CLIENT_ID
  • GITHUB_CLIENT_SECRET
  • GITHUB_REDIRECT_URI
  • CHATGPT_REDIRECT_URI
  • PORT
  • FOUNDRY_DATA_PATH

Security Notes

The server demonstrates good security practices including input validation with Zod, use of environment variables for API keys and secrets, and a `safeResponse` utility to sanitize outgoing data (removing keys like 'privateKey', 'apiKey', 'password'). WebSocket connections are authenticated using an API key. OAuth 2.0 routes are present with client ID/secret validation. A deduplication middleware helps prevent replay attacks for specific POST requests. A minor potential misconfiguration risk exists with the default `CORS_URL` being `*`, though its impact is limited to static asset serving in the current setup.

Similar Servers

Stats

Interest Score0
Security Score9
Cost ClassMedium
Avg Tokens150
Stars0
Forks0
Last Update2026-01-01

Tags

Foundry VTTLLM IntegrationRelay ServerTTSImage Generation