MonoGame MCP Server

A Model Context Protocol (MCP) server for the MonoGame framework. It provides AI-powered documentation lookup, project management, code scaffolding, and diagnostic tools for MonoGame development.

Quick Start

1. Install prerequisites (.NET SDK 8.0 and MonoGame templates).

2. Configure your MCP client (like Claude Desktop) to use npx monogame-mcp.

3. Restart your client and start building MonoGame projects.

Prerequisites

• Node.js: version 18 or higher.

• .NET SDK 8.0: Required for building and running projects. Verify with dotnet --version.

• MonoGame Templates: Install with dotnet new install MonoGame.Templates.CSharp.

• MGCB Tool: Install for content builds with dotnet tool install -g dotnet-mgcb.

Installation

Using npx (Recommended)

You can run the server directly without local installation:

npx monogame-mcp

Global Installation

npm install -g monogame-mcp

Docker

docker run -i monogame-mcp

Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "monogame-mcp": {
      "command": "npx",
      "args": ["-y", "monogame-mcp"]
    }
  }
}

If using Docker:

{
  "mcpServers": {
    "monogame-mcp": {
      "command": "docker",
      "args": ["run", "-i", "monogame-mcp"]
    }
  }
}

Available Tools

Available Resources

Available Prompts

Examples

1. Creating a New Project

Tell the AI: "Create a new MonoGame DesktopGL project named SpaceExplorer, add a background.png texture to content, and build it." The AI will use monogame_create_project, then monogame_manage_content, and finally monogame_build_content.

2. Learning the API

Ask: "How do I use SpriteBatch to draw a scaled texture?" The AI will use monogame_api_lookup or read monogame://api/SpriteBatch to provide exact parameters and code.

3. Fixing Errors

If you get an error: "ContentLoadException: The content file was not found." Provide the error to the AI. It will use monogame_diagnose_error to identify that you likely missed adding the asset to your .mgcb file or have a path mismatch.

4. Scaffolding and Running

Ask: "Generate a scene manager class for my game and then try to run the project." The AI will use monogame_scaffold_code with the scene-manager template, then monogame_build_run with the run action.

Development

1. Clone the repository.

2. Install dependencies: npm install

3. Build the project: npm run build

4. Run tests: npm test

5. Link for local testing: npm link

License

MIT