使用说明
MonoGame MCP服务器
MonoGame框架的模型上下文协议（MCP）服务器。它为MonoGame开发提供人工智能驱动的文档查找、项目管理、代码脚手架和诊断工具。
快速开始
- 安装必备组件（.NET SDK 8.0和MonoGame模板）。
- 配置您的MCP客户端（如Claude Desktop）以使用
npx monogame-mcp. - 重启你的客户端，开始构建MonoGame项目。
先决条件
- Node.js：版本18或更高版本。
- .NET SDK 8.0：建设和运行项目所需。证实
dotnet --version. - MonoGame模板：安装
dotnet new install MonoGame.Templates.CSharp. - MGCB工具：安装内容生成
dotnet tool install -g dotnet-mgcb.
安装
使用npx（推荐）
您可以直接运行服务器，无需本地安装：
npx monogame-mcp
全球安装
npm install -g monogame-mcp
码头工人
docker run -i monogame-mcp
配置
克劳德桌面版
将此添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"monogame-mcp": {
"command": "npx",
"args": ["-y", "monogame-mcp"]
}
}
}
如果使用Docker：
{
"mcpServers": {
"monogame-mcp": {
"command": "docker",
"args": ["run", "-i", "monogame-mcp"]
}
}
}
可用工具
| 工具名称 | 描述 | 示例用法 |
|---|---|---|
monogame_api_lookup |
搜索MonoGame API文档中的类、方法和属性 | { "query": "SpriteBatch" } |
monogame_create_project |
使用.NET模板创建一个新的MonoGame项目 | { "projectName": "MyGame", "template": "desktopgl" } |
monogame_manage_content |
在.mgcb内容项目中添加、删除或配置资产 | { "action": "add", "mgcbPath": "Content.mgcb", "assetPath": "player.png" } |
monogame_build_content |
使用MGCB CLI构建MonoGame内容 | { "mgcbPath": "Content/Content.mgcb" } |
monogame_scaffold_code |
从预定义模板生成MonoGame C#代码 | { "template": "game-class", "className": "MainGame" } |
monogame_diagnose_error |
诊断MonoGame错误消息并提出修复建议 | { "errorMessage": "Could not find ContentTypeReader" } |
monogame_build_run |
使用.NET CLI构建或运行MonoGame项目 | { "action": "run", "projectPath": "MyGame.csproj" } |
可用资源
| URI模板 | 描述 | 示例URI |
|---|---|---|
monogame://api/{className} |
MonoGame类的API参考文档 | monogame://api/Texture2D |
monogame://examples/{topic} |
代码示例和开发教程 | monogame://examples/sprite-animation |
monogame://content-pipeline/{topic} |
内容管道文档 | monogame://content-pipeline/overview |
monogame://platforms/{platform} |
平台特定指南 | monogame://platforms/android |
可用提示
| 提示名称 | 参数 | 描述 |
|---|---|---|
monogame_code_review |
code （必填）， focus |
查看MonoGame最佳实践的C#代码 |
monogame_troubleshoot |
error （必填）， code, platform |
排除错误和异常 |
monogame_architecture |
gameType （必填）， features, scale |
规划游戏架构和组织 |
monogame_implement_feature |
feature （必填）， existingCode, platform |
分步功能实施指南 |
例子
1.创建新项目
告诉AI：“创建一个名为SpaceExplorer的新MonoGame DesktopGL项目，为内容添加background.png纹理，然后构建它。”
AI将使用 monogame_create_project那么 monogame_manage_content，最后 monogame_build_content.
2.学习API
问：“如何使用SpriteBatch绘制缩放纹理？”
AI将使用 monogame_api_lookup 或阅读 monogame://api/SpriteBatch 以提供精确的参数和代码。
3.修复错误
如果您收到错误：“ContentLoadException:找不到内容文件。”
将错误提供给AI。它将使用 monogame_diagnose_error 确定您可能错过了将资产添加到您的 .mgcb 文件或路径不匹配。
4.脚手架和运行
问：“为我的游戏生成一个场景管理器类，然后尝试运行项目。”
AI将使用 monogame_scaffold_code 随着 scene-manager 模板，然后 monogame_build_run 随着 run 行动。
发展
- 克隆存储库。
- 安装依赖项：
npm install - 构建项目：
npm run build - 运行测试：
npm test - 本地测试链接：
npm link
许可证
麻省理工学院
