defold-mcp

What is defold-mcp?

defold-mcp is an open-source Model Context Protocol (MCP) server that bridges the Defold game engine with AI-powered developer tools. It provides a set of tools to automate, inspect, and manage Defold projects programmatically, aimed at game developers using Defold.

How to use defold-mcp?

Clone the repository, run npm install, optionally configure a .env file, then start the server with node index.js. Connect with any MCP-compatible client, such as Cursor or Windsurf, by adding a .cursor/mcp.json configuration that points to your Node.js binary and the index.js file. Set environment variables like DEFOLD_PATH, MCP_PORT, and BOB_PATH as needed.

Key features of defold-mcp

• Exposes 20+ Defold project operations as MCP tools
• Works on Apple Silicon and supports .env configuration
• Automates creating, listing, and configuring Defold projects
• Generates Lua scripts, collections, sprites, and tilemaps programmatically
• Debugs projects and captures console output
• Enables hot-reloading and analytics on project modifications

Use cases of defold-mcp

• Launch and debug a Defold project from an AI assistant
• Generate and edit Lua scripts and modules automatically
• Create collections, sprites, tilemaps, and particle effects via code
• Manage project settings and dependencies without opening the editor
• Integrate Defold with Cursor or Windsurf for AI-assisted game development

FAQ from defold-mcp

How do I use defold-mcp with Cursor or Windsurf?

Add a .cursor/mcp.json file to your project with the path to your Node.js binary and the index.js file, along with environment variables such as MCP_TRANSPORT, DEFOLD_PATH, and BOB_PATH. The client will automatically start and manage the server.

What runtime dependencies does defold-mcp require?

Node.js and npm are required. Additionally, you need a local installation of the Defold editor and optionally the Defold Bob build tool (specified via BOB_PATH).

Where does defold-mcp store project data?

Project data is read from and written to local Defold project directories on your machine. No external database or cloud storage is used.

What transport and authentication methods does defold-mcp support?

By default, it uses stdio transport (set via MCP_TRANSPORT). It can also be configured for network transport using MCP_PORT and MCP_HOST environment variables. No authentication is mentioned.

Is defold-mcp production-ready?

This is the author’s first MCP server and intentionally incomplete—many features are missing. The project is shared as a starting point for the community to improve and extend.