GDevelop MCP
GDevelop MCP, what exists today and what an agent can do
GDevelop has its own AI agent inside the editor, and a few community MCP servers let Claude Code or Cursor work on a GDevelop project from outside. Here is what each does, where they stop, and when an engine with a full MCP server is the better fit.
要点
There is no official GDevelop MCP server. We found no MCP code in the 4ian/GDevelop repository, and the open GitHub request for bring your own model support in the built-in agent is still under discussion. GDevelop's own AI agent lives in the Ask AI panel and edits scenes, objects, behaviours, variables and events using GDevelop credits. Community servers such as gdevelop-mcp by gb2b (MIT, 30 tools) edit the project JSON and render previews for Claude Code or Cursor. If you want an agent that runs the game, sends input and checks the result in a native engine, Summer Engine does that, but it does not import GDevelop projects. Moving means rebuilding.
GDevelop users searching for an MCP server usually want one thing. They already pay for Claude Code, Cursor or Codex and would rather use that agent than a second AI subscription inside the editor. That is a reasonable wish, and GDevelop's issue tracker shows it. A bring your own key request for the built-in agent has been open since October 2025.
Until something official exists, you have two routes inside GDevelop. Use GDevelop's own agent, which knows the editor and every official extension, or connect a community MCP server that reads and writes the project files from outside.
This page covers both with sources, explains what the GDevelop project format means for an outside agent, and describes the alternative of building in an engine whose MCP server also plays the game and looks at it.
できること
GDevelop's built-in agent
Open Ask AI and choose Build for me. GDevelop documents that the agent creates scenes, objects, behaviours, variables and events and installs extensions. Requests use credits. Free accounts get a weekly allowance, and higher reasoning levels need a Gold or Pro subscription.
gdevelop-mcp by gb2b
An MIT server with 30 tools and 5 prompts. It reads GDevelop's own source for its catalogue of about 1,830 actions, conditions and expressions, edits projects with dry runs, backups and undo, and captures a preview of a scene in headless Chromium.
gdevelop-mcp-server by 982945902
A smaller MIT server built for Codex. It uses GDevelop's libGD.js to create and change project data, authors events without hand-written JSON, and serves a scene preview on a local address.
What an outside agent can see
gdevelop-mcp renders a scene statically or captures a still from a real preview in headless Chromium, and gdevelop-mcp-server serves a live preview on a local address. Neither README lists a way to send input to the running game or read its state frame by frame, so testing a mechanic still means playing it yourself.
Summer as the engine-level alternative
Summer Engine is a desktop engine compatible with Godot 4. Its MCP server edits scenes and GDScript, presses play, sends scripted input, reads frame-stamped probes and takes screenshots, so the agent verifies a mechanic by playing it.
Generators that work for GDevelop too
Summer's cloud tools generate sprites, sprite sheets, backgrounds, sound effects and music without the Summer engine running. Download the files and add them to your GDevelop project as usual.
使い方
- 1
ステップ 1: Switch the project to multiple files
In the project properties, turn on saving the project as multiple files in a folder. Scenes, external layouts, external events and extensions each get their own JSON file, which makes an agent's changes small and reviewable. Put the folder in Git.
- 2
ステップ 2: Pick the agent route
Use GDevelop's Ask AI if you want the editor's own agent and credits. Use a community MCP server if you want Claude Code, Cursor or Codex. Install it from its README and point it at your project JSON.
- 3
ステップ 3: Make every edit a dry run first
gdevelop-mcp previews each change before it writes, keeps timestamped backups and can undo the last edit. Ask for a dry run, read the diff, then apply. Reopen the project in GDevelop to confirm it loads.
- 4
ステップ 4: Rebuild in Summer only if you want the full loop
If you want the agent to play and verify the game, rebuild a vertical slice in Summer. Objects become nodes, behaviours become scripts or built-in nodes, and your event sheets are the specification.
2つの使い方
Studio で、またはいつものエージェントから
Summer Studio で
Summer Studio on the web generates sprites, backgrounds, sound effects, voice lines and music for any engine. Download the files and import them into GDevelop.
Open the image tab in StudioClaude、Cursor、Codex から MCP 経由で
You can register the Summer MCP next to a GDevelop MCP server in the same client. Summer's cloud tools such as summer_generate_image and summer_generate_audio work without the Summer desktop app, and summer_get_asset_download_url gives the agent a download link for each file.
エージェントへのプロンプト例
Generate a coin pickup sound and a looping 30 second chiptune track with Summer, get me download links for both, and save them into the assets folder of my GDevelop project.Summer MCP をセットアップ
| Route | Maker | What it does | Cost |
|---|---|---|---|
| Ask AI, Build for me | GDevelop (official) | Creates scenes, objects, behaviours, variables and events inside the editor | GDevelop credits, weekly free allowance |
| gdevelop-mcp | gb2b | 30 tools, validated edits with undo, static render and headless Chromium preview | Free, MIT |
| gdevelop-mcp-server | 982945902 | Create and edit projects through libGD.js, author events, serve a local preview | Free, MIT |
| Official MCP server | None found | No MCP code in 4ian/GDevelop; bring your own model request still open | Not applicable |
| Task | GDevelop with an MCP server | Summer MCP |
|---|---|---|
| Read and edit game logic | Event sheets in JSON through the server | GDScript files and the scene tree |
| Create objects and scenes | Yes, through validated edits | Yes |
| See the result | Rendered still of a scene | Editor and game screenshots, snapshot diffs |
| Send input to the running game | Not listed | Yes |
| Read state at a given frame | Not listed | Yes, frame-stamped probes |
| Generate art and audio | GDevelop's asset store or any external generator | Built in |
料金
費用
- 画像、Nano Banana 2 Lite(1K)
- $0.06概算
- 効果音、5 秒
- $0.01
Community GDevelop MCP servers are free to run. GDevelop's built-in agent uses GDevelop credits. Summer charges only for generation, from your usage balance.
料金は Summer の利用残高から差し引かれます。アセット生成には有料プランかチャージが必要です。Pro は月額 $20 で $20 分の利用が含まれ、チャージは $5 から。デスクトップエンジン自体は無料でダウンロードできます。
すべてのプランを見る例
使えるプロンプトと、その結果
What an outside agent does well with a GDevelop project, and one job that needs a different engine.
Explain a project
プロンプト
Summarise every scene in my game.json, which objects each uses and which events change the score.
得られるもの
A structured read of the project. This is safe and fast with any server that parses the JSON.
Add a mechanic from an example
プロンプト
Add a double jump to my Player object, as a dry run first.
得られるもの
A proposed edit with a diff you can review before anything is written.
Preview a scene
プロンプト
Render the Level1 scene and show me what it looks like after the change.
得られるもの
A still of the scene from gdevelop-mcp's static render or its headless Chromium capture.
Generate game audio
プロンプト
Make a jump sound, a hurt sound and a short victory jingle in a retro style.
得られるもの
Three audio files from Summer's generator, downloaded into your project's assets folder.
Test the mechanic by playing
プロンプト
Run the game, jump twice at the first gap and tell me whether the player clears it.
得られるもの
Not listed by the GDevelop servers we read. In Summer the agent sends input, probes the player and shows a screenshot.
What the GDevelop project format means for an agent
A GDevelop project is JSON. By default it is one game.json file. In multiple files mode the scenes, external layouts, external events and extensions are split into their own files, and GDevelop recommends that mode for version control. GDevelop also warns that cloud sync tools such as Dropbox or OneDrive watching the folder can corrupt the project JSON.
Events are the hard part. In the official platformer example each condition and action is an object with a type such as `SystemInfo::HasTouchScreen` or `BuiltinExternalLayouts::CreateObjectsFromExternalLayout` and a list of positional string parameters, where text values carry their own escaped quotes. An agent editing that by hand has to get every identifier, parameter position and nesting level right, or the event loads but does not do what you meant. This is why the useful community servers validate edits against GDevelop's own sources or library instead of writing text. GDevelop also has JavaScript events, which an agent can write more reliably than raw event JSON.
When to stay in GDevelop
Stay if you like building with events, if your team is not writing code, or if HTML5 publishing to many web destinations is the core of your release. GDevelop is built around that, while Summer web builds play on Summer Games. Stay too if the built-in agent's credits suit you. It knows every official extension and edits the project from inside the editor, which avoids the file format problem altogether.
When to move a GDevelop game to an engine with a full MCP server
Move when you want the agent to test, not only edit. Summer's agent runs the game, sends input, reads the player's position at the frame it lands, takes a screenshot and fixes what it finds. You write in GDScript, with C# available in the desktop editor, and you own the project with no royalties.
Summer does not import GDevelop projects. The rebuild reuses your art, audio and level design, and your event sheets become the specification for scripts. Summer builds desktop games for Windows and macOS for Steam and itch.io.
よくある質問
Is there an official GDevelop MCP server?
Not that we could find. The 4ian/GDevelop repository has no MCP code, and a request to let the built-in agent use your own model or key has been open since October 2025.
Can Claude Code or Cursor edit a GDevelop project?
Yes, through a community MCP server such as gdevelop-mcp by gb2b or gdevelop-mcp-server by 982945902. They parse the project JSON and write validated changes. Commit to Git before each session.
Is GDevelop's AI agent free?
GDevelop documents a weekly free allowance for its AI. Requests use credits, higher reasoning levels need a Gold or Pro subscription, and you can buy extra credits.
Can an agent edit GDevelop events safely?
Only through a tool that understands the event format. Raw JSON edits easily produce events that load but never fire. Use a server with dry runs and undo, or GDevelop's own agent, and reopen the project to check.
Can Summer import my GDevelop project?
No. Moving from GDevelop to Summer means rebuilding, with your assets reused and your events as the specification. Summer exports web builds that play on Summer Games, but GDevelop documents more web destinations.
How does GDevelop compare with Godot for AI work?
GDevelop is event based with a built-in agent. Godot 4 projects are code and scene files that terminal agents handle well, and Summer adds an MCP server that runs and checks the game. Our Godot vs GDevelop guide goes deeper.
関連ツールとガイド
出典
- Build and learn with GDevelop AI (GDevelop documentation)
- GDevelop's AI Agent (GDevelop blog)
- How to use GDevelop as a team (GDevelop documentation)
- BYOK support for GDevelop AI Agent, issue 7932
- gb2b/gdevelop-mcp on GitHub
- 982945902/gdevelop-mcp-server on GitHub
- gdexporter, export GDevelop games from the command line
- GDevelop official platformer example project
ゲームを作る。ゲームを育てる。
ほかのエンジンで作ったゲームでも。
macOS(Apple シリコン)と Windows 向けに無料でダウンロード。