godotmcp (Rectangle Equals)

MCP开发工具

提供方 RectangleEquals

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeVS Code
查看接入方式

GodotMCP是一个基于模型上下文协议(MCP)的服务,通过AI助手管理Godot游戏项目,提供项目管理、文件操作、Git集成和调试支持。

一句话选型结论

按资料字段整理

godotmcp (Rectangle Equals) 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

游戏开发Python本地部署项目管理AI辅助Git集成调试工具

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -it --rm \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
godotmcp (Rectangle Equals)当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方RectangleEquals上游标注的维护方 RectangleEquals
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.2 KB
来自项目仓库与上游目录的原文,未做删改

GodotMCP

基于人工智能的Godot 4.4+通过模型上下文协议进行项目管理

GodotMCP是一个模型上下文协议(MCP)服务器,使Claude和其他AI助手能够通过GodotAI GDExtension管理Godot游戏项目。它提供全面的项目管理、文件操作、基于git的修改跟踪和调试功能,所有这些都具有用户审批工作流。

🎯 特性

  • 📁 项目管理:获取项目信息、文件结构和Godot设置
  • 📝 文件操作:使用git跟踪读取、创建、修改和删除文件
  • 🔄 Git集成:具有差异查看、批准/拒绝、撤消/重做功能的完整git工作流
  • 🐛 调试支持:通过VS Code集成运行和调试Godot项目
  • 🔒 权限系统:精细的文件夹访问控制和自动审批规则
  • ✅ 用户批准:在申请之前,审查并批准所有AI建议的更改
  • 📊 变更历史:跟踪和浏览所有修改

🏗️ 建筑```

Claude Desktop ↔ Docker MCP Toolkit ↔ GodotMCP (Docker) ↔ GodotAI (GDExtension) ↔ Godot Project


- **GodotMCP**:运行在Docker中的Python MCP服务器,代理Claude和GodotAI之间的请求
- **GodotAI**:C++GDExtension在Godot项目中运行,执行实际的文件和git操作
- **沟通**:GodotMCP和GodotAI之间的异步HTTP/SSE,克劳德桌面的stdio

## 📋 先决条件

- **Windows 10/11** WSL 2
- **Docker桌面** 启用MCP Toolkit测试版功能
- **克劳德桌面** 对于Windows
- **戈多4.4+** 与您的游戏项目
- **Python 3.11+** (用于发展)

## 🚀 快速开始

### 1.克隆存储库```bash
git clone https://github.com/RectangleEquals/godotmcp.git
cd godotmcp

2.运行安装脚本

打开PowerShell并运行:```powershell
.\install.ps1


这将:

- 将MCP配置文件复制到Docker MCP目录
- 构建Docker镜像
- 在Docker Desktop上注册服务器
- 可选配置克劳德桌面

### 3.安装GodotAI GDExtension

*(GodotAI设置说明将另行提供)*

1. 从发布页面下载GodotAI
1. 提取到 `res://addons/godotai/` 在您的Godot项目中
1. 配置 `res://addons/godotai/config.json`
1. 在Godot的项目设置中启用插件

### 4.在Claude Desktop中开始使用

打开克劳德桌面,您现在可以使用GodotMCP工具:```
Can you show me the structure of my Godot project?
``````
Create a new Player script at res://scripts/player.gd with basic movement code
``````
Show me pending changes and let me approve them

🔧 配置

环境变量

GodotMCP支持以下环境变量:

变量 默认值 描述
MCP_HOST 127.0.0.1 MCP服务器主机
MCP_PORT 8080 MCP服务器端口
GODOTAI_HOST host.docker.internal GodotAI运行的主机
GODOTAI_PORT 9876 GodotAI正在监听的端口
GODOTAI_TIMEOUT 30 GodotAI请求超时(秒)

您可以在Docker配置中或构建映像时设置这些。

GodotAI配置

通过编辑配置GodotAI res://addons/godotai/config.json:```json
{
"listen_port": 9876,
"permissions": {
"allowed_folders": [
"res://scripts/",
"res://scenes/
",
"res://assets/"
],
"denied_folders": [
"res://addons/godotai/
"
]
},
"auto_approve": {
"patterns": [],
"max_file_size_kb": 0
},
"auto_deny": {
"patterns": [
"/*.import",
".godot/
"
]
},
"max_undo_history": 50,
"enable_debug_mode": false
}


## 📚 可用工具

### 项目信息

- `get_project_info` -获取项目名称、Godot版本和设置
- `get_project_structure` -获取完整的文件/文件夹结构
- `get_git_status` -获取当前git状态和历史记录

### 文件操作

- `read_file(path)` -读取文件内容
- `list_files(directory)` -列出目录中的文件
- `search_files(pattern, directory)` -搜索与模式匹配的文件

### 文件修改(Git跟踪)

- `create_file(path, content, commit_message)` -创建新文件
- `modify_file(path, content, commit_message)` -修改现有文件
- `delete_file(path, commit_message)` -删除文件

### Git工作流

- `get_pending_changes()` -查看等待批准的更改
- `approve_changes(change_ids)` -批准一项或多项更改
- `deny_changes(change_ids)` -拒绝并恢复更改
- `retry_change(change_id)` -拒绝并要求克劳德重试
- `undo_changes(count)` -撤消最近的更改
- `redo_changes(count)` -重做已撤消的更改
- `get_change_history(limit)` -查看更改历史记录

### 调试与执行

- `run_project(scene)` -运行Godot项目
- `debug_project(scene, breakpoints)` -使用VS代码开始调试
- `stop_project()` -停止运行/调试项目
- `get_debug_logs(since, level)` -获取调试日志

### 配置

- `get_godotai_config()` -获取GodotAI设置
- `update_godotai_config(config)` -更新GodotAI设置
- `health_check()` -检查GodotAI连接状态

## 🔄 工作流示例

### 创建和批准更改

1. **让Claude创建一个文件:**```
Create a player controller script at res://scripts/player_controller.gd
  1. 克劳德使用 create_file 工具 -创建文件并跟踪git

  2. 查看待定更改:```
    Show me what changes are pending approval


1. **查看差异** -克劳德给你看git diff

1. **批准或拒绝:**```
Approve all pending changes

或```
Deny the last change and let's try again with more detailed comments


1. **必要时撤消:**```
Actually, undo the last 2 changes

🏗️ 项目结构```

godotmcp/
├── src/
│ └── godot_mcp_server/
│ ├── init.py # Package init
│ └── server.py # Main MCP server
├── .mcp/
│ └── catalog/
│ ├── custom-catalog.yaml # MCP catalog config
│ └── v3/
│ └── tools/
│ └── godotmcp.json # Tool definitions
├── .claude/
│ └── claude_desktop_config.json # Claude Desktop config
├── Dockerfile # Docker container config
├── pyproject.toml # Python project config
├── install.ps1 # Windows installation script
├── README.md # This file
└── LICENSE # MIT License


## 🧪 发展

### 在当地建设```bash
# Build Docker image
docker build -t godotmcp:latest .

# Run locally for testing
docker run -it --rm \
-e GODOTAI_HOST=host.docker.internal \
-e GODOTAI_PORT=9876 \
godotmcp:latest

运行测试```bash

Install dev dependencies

pip install -e ".[dev]"

Run tests

pytest

Format code

black src/

Type checking

mypy src/
```

🤝 贡献

欢迎投稿!请随时提交拉取请求。

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 相关项目

  • GodotAI -GodotMCP与之通信的C++GDExtension (即将推出)
  • calcmcp -此项目所基于的模板MCP服务器
  • Godot-更多-更多 -GDExtension项目模板

💬 支持

  • 打开问题以获取错误报告或功能请求
  • 检查 模型上下文协议文档
  • 加入GitHub讨论

🙏 致谢

  • 建立在 模型上下文协议
  • 用途 FastMCP 用于服务器实现
  • 受到对更好的AI辅助游戏开发工作流程需求的启发

⚠️ 备注:GodotMCP目前处于测试阶段。GodotAI GDExtension组件正在积极开发中。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
godotmcp (Rectangle Equals) 怎么安装?

在客户端按下面的安装命令接入:docker run -it --rm \。装完在客户端配置里引用同一个包或端点。

godotmcp (Rectangle Equals) 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

godotmcp (Rectangle Equals) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

godotmcp (Rectangle Equals) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

godotmcp (Rectangle Equals) 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

godotmcp (Rectangle Equals) 能提供哪些能力?

资料显示能力标签包括 游戏开发、调试工具、Python、Claude、Git集成。具体工具清单以官方文档为准。

godotmcp (Rectangle Equals) 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

godotmcp (Rectangle Equals) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。