defold-mcp
2025.04.27
1
JavaScript游戏开发工具自动化工具开发效率
defold-mcp 是一个开源的 Model Context Protocol (MCP) 服务器，旨在将 Defold 游戏引擎与现代开发者工具和 AI 驱动的工作流程连接起来。它提供了一套强大的工具，用于以编程方式自动化、检查和管 Defold 项目，使开发者能够更轻松地启动和调试项目、生成和编辑 Lua 脚本、管理项目设置和依赖项等。
View on GitHub
Overview
基本能力
产品定位
defold-mcp 是一个为 Defold 游戏引擎设计的 MCP 服务器，旨在通过自动化工具和 AI 辅助工作流程提升游戏开发效率。
核心功能
- 自动化项目管理：创建、列出和配置 Defold 项目。
- 脚本与资源自动化：生成 Lua 脚本、集合、精灵、瓦片地图等资源。
- 调试与分析：运行调试模式、捕获控制台输出、获取项目修改分析。
- 扩展性：支持通过工具扩展和自定义工作流程。
适用场景
- 游戏开发：快速生成和管理 Defold 项目资源。
- AI 辅助开发：与 Cursor 或 Windsurf 等工具集成，实现 AI 驱动的自动化开发。
- 团队协作：通过自动化工具简化多人协作中的项目管理。
工具列表
launch_defold: 启动 Defold 编辑器。run_project: 在调试模式下运行项目并捕获输出。create_project: 创建新的 Defold 项目。list_projects: 列出目录中的所有 Defold 项目。create_script: 创建新的 Lua 脚本。edit_script: 编辑现有 Lua 脚本。create_collection: 创建新的集合。add_game_object: 向集合添加游戏对象。add_component: 向游戏对象添加组件（如精灵、脚本等）。create_sprite: 创建精灵资源。create_tilemap: 创建瓦片地图资源。build_project: 为目标平台构建项目。enable_hot_reload: 启用热重载功能。
常见问题解答
- 如何与 Cursor 或 Windsurf 集成？
在项目根目录创建
.cursor/mcp.json配置文件，指定 Node.js 路径和服务器参数。 - 如何配置环境变量？
创建
.env文件覆盖默认配置（如DEFOLD_PATH、MCP_PORT等）。
使用教程
使用依赖
- 确保已安装 Node.js 和 Git。
安装教程
- 克隆仓库：
bash git clone https://github.com/yourusername/defold-mcp.git cd defold-mcp - 安装依赖：
bash npm install - 配置环境（可选）：
创建
.env文件并设置变量（如DEFOLD_PATH）。 - 启动服务器：
bash node index.js
调试方式
- 使用
run_project工具运行项目并捕获输出：bash node index.js run_project --project=/path/to/project - 检查控制台日志或使用
get_project_analytics获取修改分析。