Installation

FICSIT Foreman runs locally with Docker Compose — the web app, its backend, and the unified MCP server, grouped under one foreman project.

Docker Compose (recommended)

From a clone of the repository (for its compose.yaml):

docker compose up -d        # pulls the images the first time

This starts three services:

Service	Port	What
`ff-client` (web app)	8725	the foreman UI — open `http://localhost:8725`
`ff-server` (backend)	8724	LLM proxy, sessions, work orders, MCP gateway
`sf-mcp` (MCP server)	8723	game-data + live save-game tools (`/health`, `/mcp`)

It serves the bundled stable game data out of the box. To chat with the foreman you need an LLM API key — see Anthropic or OpenAI.

If you only want the MCP tools for your own AI client, run the server image on its own:

docker run -d --name foreman-sf-mcp -p 8723:8723 ghcr.io/stuartmeeks/foreman-sf-mcp:latest

It serves the bundled stable data on http://localhost:8723 (health check: http://localhost:8723/health), then connect a client.

The full Docker / Windows walkthrough — and the from-source (Node.js) path — are in the repository README.

FICSIT Foreman