com.IvanMurzak.GameDev.MCP.Server 9.6.0

dotnet tool install --global com.IvanMurzak.GameDev.MCP.Server --version 9.6.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local com.IvanMurzak.GameDev.MCP.Server --version 9.6.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=com.IvanMurzak.GameDev.MCP.Server&version=9.6.0
                    
nuke :add-package com.IvanMurzak.GameDev.MCP.Server --version 9.6.0
                    

AI Game Developer — GameDev MCP Server

NuGet Docker .NET 10 License Discord Stand with Ukraine

Engine-agnostic Model Context Protocol server shared by the game-engine MCP plugins:

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 package — 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

dotnet tool (this package)

dotnet tool install --global com.IvanMurzak.GameDev.MCP.Server
gamedev-mcp-server --port 8080

Typical MCP client configuration (stdio):

{
  "mcpServers": {
    "GameDev-MCP": {
      "command": "gamedev-mcp-server",
      "args": ["--port=8080", "--client-transport=stdio"]
    }
  }
}

Docker

Inside a container the server must listen on all interfaces (MCP_BIND=any), or the port mapping cannot reach it:

docker run --rm -p 127.0.0.1:8080:8080 \
  -e MCP_PLUGIN_CLIENT_TRANSPORT=streamableHttp -e MCP_BIND=any \
  aigamedeveloper/mcp-server

Pre-built executables

Download gamedev-mcp-server-<rid>.zip for Windows, Linux or macOS from Releases, unzip, and run:

./gamedev-mcp-server --port 8080 --client-transport stdio

Configuration

Every option is an environment variable or a CLI argument (arguments win). The ones you will reach for:

CLI argument Environment variable Default Meaning
--port MCP_PLUGIN_PORT 8080 Port for AI clients and the engine plugin
--client-transport MCP_PLUGIN_CLIENT_TRANSPORT stdio stdio or streamableHttp
--tool-timeout MCP_PLUGIN_TOOL_TIMEOUT 300000 Max time for one tool call (ms)
--auth MCP_AUTH by transport none, token or oauth
--bind MCP_BIND loopback loopback, any or an IP

More options: Configuration. Auth modes: Hosting and authentication.

In stdio mode console logging is redirected to stderr so stdout stays clean for the MCP JSON stream.

The default level is Info. MCP_LOG_LEVEL=Trace dumps every MCP message body for debugging; it is very high volume and rotates server-log.txt down to a few minutes of retained history, so set it only while reproducing an issue.

Write a pinned, URL-only MCP client config for an AI agent from the terminal: gamedev-mcp-server configure --agent claude-code (or --agent codex --url https://ai-game.dev/mcp; configure --help lists all agents).

Compatibility

GameDev-MCP-Server McpPlugin.Server ReflectorNet Engine plugins
9.2.5 and newer (latest release) 8.x 5.x engine plugins on McpPlugin 8.x
9.2.4 (last 7.x) 7.5.2 5.4.0 engine plugins on McpPlugin 7.x
8.0.3 (legacy) 6.11.0 5.3.1 engine plugins on McpPlugin 6.x

Server releases 9.2.5 and newer build against McpPlugin 8.x; 9.0.0–9.2.4 build against McpPlugin 7.x (the instance-metadata handshake + oauth mode), and McpPlugin 6.x plugins pair with the 8.0.3 line. For the exact pins of an intermediate version see its entry on Releases.

License

Apache-2.0 — Copyright © 2026 Ivan Murzak

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
9.6.0 0 11/21/2026
9.5.5 71 11/19/2026
9.5.4 113 11/14/2026
9.5.3 101 11/14/2026
9.5.2 111 11/12/2026
9.5.1 104 11/12/2026
9.5.0 96 11/11/2026
9.4.4 117 11/9/2026
9.4.3 99 11/8/2026
9.4.2 102 11/8/2026
9.4.1 104 11/7/2026
9.4.0 99 11/5/2026
9.3.2 133 11/3/2026
9.3.1 131 10/31/2026
9.3.0 116 10/30/2026
9.2.17 128 10/23/2026
9.2.16 111 10/23/2026
9.2.15 113 10/22/2026
9.2.14 122 10/22/2026
9.2.13 114 10/20/2026
Loading failed

Recover from authorization-service outages without treating valid credentials as revoked.