IvanMurzak/GameDev-MCP-Server

  
  
  
  
  
  
  
  
  
  
  
Engine-agnostic Model Context Protocol server shared by the game-engine MCP plugins:
Unity-MCP — Unity Editor & games
Godot-MCP — Godot Editor & games
Unreal-MCP — Unreal Editor & games
It is a thin host over the NuGet packages com.IvanMurzak.McpPlugin.Server and com.IvanMurzak.ReflectorNet, where all the real server logic lives. The server bridges MCP clients (Claude, Cursor, Copilot, …) and an engine plugin over SignalR:
MCP client ⇄ gamedev-mcp-server ⇄ (SignalR) ⇄ engine plugin (Unity / Godot / Unreal)
There is no engine-specific code in this repository — one server binary serves all three engine plugins. Tools, resources and prompts are provided dynamically by whichever engine plugin connects.
> Not to be confused with AI-Game-Dev-Server — the cloud LLM/billing proxy. This project is the local MCP stdio/http proxy host.
## Install / Run
### Pre-built executables
Download the zip for your platform from Releases (gamedev-mcp-server- .zip — win-x64, win-x86, win-arm64, linux-x64, linux-arm64, osx-x64, osx-arm64), unzip, and run:
bash
./gamedev-mcp-server --port 8080 --client-transport stdio
Typical MCP client configuration (stdio):
json
"mcpServers": {
"GameDev-MCP": {
"command": "path/to/gamedev-mcp-server",
"args": ["--port=8080", "--client-transport=stdio"]
### Docker
bash
docker run -i --rm -p 8080:8080 aigamedeveloper/mcp-server
### dotnet tool
bash
dotnet tool install --global com.IvanMurzak.GameDev.MCP.Server
gamedev-mcp-server --port 8080
### Build from source
bash
dotnet build com.IvanMurzak.GameDev.MCP.Server.csproj
dotnet run --project com.IvanMurzak.GameDev.MCP.Server.csproj -- --client-transport stdio --port 8080
Cross-platform self-contained executables for all 7 RIDs: ./build/build-all.sh (bash) or ./build/build-all.ps1 (PowerShell). Outputs land in publish/ / and are zipped as gamedev-mcp-server- .zip (skip zipping with --no-zip / -NoZip).
## Configuration
CLI arguments override environment variables.
| Environment variable | CLI argument | Default | Description |
| MCPPLUGINPORT | --port | 8080 | Client → Server ← Plugin connection port |
| MCPPLUGINCLIENTTIMEOUT | --plugin-timeout | 10000 | Plugin → Server connection timeout (ms): one attempt of a catalog / prompt / resource request to the plugin. Tool calls do not use it (see --tool-timeout) |
| MCPPLUGINTOOLTIMEOUT | --tool-timeout | 300000 (or --plugin-timeout if larger) | How long one tool call may run in the plugin (ms). A tool call is sent to the plugin once and never re-sent; on timeout or a dropped connection it fails, and the tool may still be running in the editor. Raise it for long editor operations (builds, imports). Servers after 9.2.12 only (built on McpPlugin 8.11.0) |
| MCPPLUGINCLIENTTRANSPORT | --client-transport | stdio | Client → Server transport: stdio or streamableHttp |
| MCPPLUGINIDLETIMEOUTSECONDS | --idle-timeout-seconds | 28800 | streamableHttp idle-session eviction window (this host seeds 8h instead of the package default of 600s, so a local session survives a working day). Multi-tenant hosts should lower it and use a Redis session-migration record for long-window resumption |