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
- Install prerequisites (.NET SDK 8.0 and MonoGame templates).
- Configure your MCP client (like Claude Desktop) to use
npx monogame-mcp. - 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
| Tool Name | Description | Example Usage |
|---|---|---|
monogame_api_lookup | Search MonoGame API documentation for classes, methods, and properties | { "query": "SpriteBatch" } |
monogame_create_project | Create a new MonoGame project using dotnet templates | { "projectName": "MyGame", "template": "desktopgl" } |
monogame_manage_content | Add, remove, or configure assets in a .mgcb content project | { "action": "add", "mgcbPath": "Content.mgcb", "assetPath": "player.png" } |
monogame_build_content | Build MonoGame content using MGCB CLI | { "mgcbPath": "Content/Content.mgcb" } |
monogame_scaffold_code | Generate MonoGame C# code from predefined templates | { "template": "game-class", "className": "MainGame" } |
monogame_diagnose_error | Diagnose MonoGame error messages and suggest fixes | { "errorMessage": "Could not find ContentTypeReader" } |
monogame_build_run | Build or run MonoGame projects using dotnet CLI | { "action": "run", "projectPath": "MyGame.csproj" } |
Available Resources
| URI Template | Description | Example URI |
|---|---|---|
monogame://api/{className} | API reference documentation for MonoGame classes | monogame://api/Texture2D |
monogame://examples/{topic} | Code examples and tutorials for development | monogame://examples/sprite-animation |
monogame://content-pipeline/{topic} | Documentation for the Content Pipeline | monogame://content-pipeline/overview |
monogame://platforms/{platform} | Platform-specific guides | monogame://platforms/android |
Available Prompts
| Prompt Name | Arguments | Description |
|---|---|---|
monogame_code_review | code (required), focus | Review C# code for MonoGame best practices |
monogame_troubleshoot | error (required), code, platform | Troubleshoot errors and exceptions |
monogame_architecture | gameType (required), features, scale | Plan game architecture and organization |
monogame_implement_feature | feature (required), existingCode, platform | Step-by-step feature implementation guidance |
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
- Clone the repository.
- Install dependencies:
npm install - Build the project:
npm run build - Run tests:
npm test - Link for local testing:
npm link
License
MIT