{"id":45710751,"url":"https://github.com/db-lyon/ue-mcp","last_synced_at":"2026-06-06T04:01:52.594Z","repository":{"id":340466142,"uuid":"1166108740","full_name":"db-lyon/ue-mcp","owner":"db-lyon","description":"Complete Unreal Engine development toolkit exposed as MCP tools.","archived":false,"fork":false,"pushed_at":"2026-06-06T02:35:39.000Z","size":10968,"stargazers_count":124,"open_issues_count":2,"forks_count":28,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-06T03:13:19.630Z","etag":null,"topics":["ai","blueprint","game-development","mcp-server","model-context-protocol","ue5","ue5-plugin","unreal-engine"],"latest_commit_sha":null,"homepage":"https://ue-mcp.com/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/db-lyon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2026-02-24T22:13:00.000Z","updated_at":"2026-06-06T02:34:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"d1535007-1ec0-4fd6-b98c-23bfe2dc0933","html_url":"https://github.com/db-lyon/ue-mcp","commit_stats":null,"previous_names":["db-lyon/ue-mcp"],"tags_count":176,"template":false,"template_full_name":null,"purl":"pkg:github/db-lyon/ue-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/db-lyon%2Fue-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/db-lyon%2Fue-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/db-lyon%2Fue-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/db-lyon%2Fue-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/db-lyon","download_url":"https://codeload.github.com/db-lyon/ue-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/db-lyon%2Fue-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33968711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","blueprint","game-development","mcp-server","model-context-protocol","ue5","ue5-plugin","unreal-engine"],"created_at":"2026-02-25T02:17:07.191Z","updated_at":"2026-06-06T04:01:52.588Z","avatar_url":"https://github.com/db-lyon.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UE-MCP\n\n**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through \u003c!-- count:tools --\u003e21\u003c!-- /count --\u003e category tools covering \u003c!-- count:actions --\u003e569+\u003c!-- /count --\u003e actions, plus a YAML flow engine for multi-step workflows.\n\n```mermaid\nflowchart LR\n    AI[AI Assistant] --\u003e|stdio| MCP[MCP Server\u003cbr/\u003eTypeScript / Node.js]\n    MCP --\u003e|WebSocket\u003cbr/\u003eJSON-RPC| Plugin[C++ Bridge Plugin\u003cbr/\u003einside Unreal Editor]\n    Plugin --\u003e|UE API| Editor[Editor Subsystems]\n    MCP --\u003e|direct fs| FS[Config INI\u003cbr/\u003eC++ Headers\u003cbr/\u003eAsset Listing]\n```\n\nBlueprints, materials, levels, actors, animation, VFX, landscape, PCG, foliage, audio, UI, physics, navigation, AI, GAS, networking, sequencer, build pipeline — all programmable through natural language.\n\n## Quick Start\n\n```bash\nnpx ue-mcp init\n```\n\nThe interactive setup will:\n\n1. Find your `.uproject` (auto-detects in current directory)\n2. Let you choose which tool categories to enable\n3. Deploy the C++ bridge plugin to your project\n4. Enable required UE plugins (Niagara, PCG, GAS, etc.)\n5. Detect and configure your MCP client (Claude Code, Claude Desktop, Cursor, Codex)\n\nRestart the editor once after setup to load the bridge plugin. To update later: `npx ue-mcp update`\n\nThen ask your AI:\n\n```\nproject(action=\"get_status\")        — verify connection\nlevel(action=\"get_outliner\")        — see what's in the level\nasset(action=\"list\")                — browse project assets\n```\n\n### Manual Configuration\n\nIf you prefer to configure manually, add to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"ue-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"ue-mcp\", \"C:/path/to/MyGame.uproject\"]\n    }\n  }\n}\n```\n\n## Documentation\n\n**[db-lyon.github.io/ue-mcp](https://db-lyon.github.io/ue-mcp/)**\n\n- [Getting Started](https://db-lyon.github.io/ue-mcp/getting-started/) — Installation, configuration, first run\n- [Architecture](https://db-lyon.github.io/ue-mcp/architecture/) — How the pieces fit together\n- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All \u003c!-- count:tools --\u003e21\u003c!-- /count --\u003e tools with \u003c!-- count:actions --\u003e569+\u003c!-- /count --\u003e actions\n- [Flows](https://db-lyon.github.io/ue-mcp/flows/) - YAML flow engine, custom tasks, rollback, hooks\n- [Configuration](https://db-lyon.github.io/ue-mcp/configuration/) — `.ue-mcp.json` and MCP client config\n- [Neon Shrine Demo](https://db-lyon.github.io/ue-mcp/neon-shrine-demo/) — Interactive guided demo\n- [Feedback](https://db-lyon.github.io/ue-mcp/feedback/) — Agent feedback system\n- [Troubleshooting](https://db-lyon.github.io/ue-mcp/troubleshooting/) — Common issues and fixes\n- [Development](https://db-lyon.github.io/ue-mcp/development/) — Building, testing, contributing\n\n## What Can It Do?\n\n| Category | Examples |\n|----------|----------|\n| **Levels** | Place/move/delete actors, spawn lights and volumes, manage splines, actor bounds |\n| **Blueprints** | Read/write graphs, add nodes, connect pins, compile, CDO property access |\n| **Materials** | Create materials and instances, author expression graphs |\n| **Assets** | CRUD, import meshes/textures/animations, datatables, mesh bounds/collision/nav |\n| **Animation** | Anim blueprints, montages, blendspaces, skeletons |\n| **VFX** | Niagara systems, emitters, parameters |\n| **Landscape** | Sculpt terrain, paint layers, import heightmaps |\n| **PCG** | Author and execute Procedural Content Generation graphs |\n| **Gameplay** | Physics, collision, navigation, navmesh inspection, behavior trees, EQS, perception, PIE damage |\n| **GAS** | Gameplay Ability System — attributes, abilities, effects, cues |\n| **Networking** | Replication, dormancy, relevancy, net priority |\n| **UI** | UMG widgets, editor utility widgets and blueprints, runtime delegate inspection |\n| **Editor** | Console, Python, PIE, viewport, sequencer, build pipeline, logs |\n| **Reflection** | Class/struct/enum introspection, gameplay tags |\n\n## Supported Platforms\n\n- **Windows** — UE 5.4–5.7\n- **Linux** — UE 5.6+ (contributed by [@robinduckett](https://github.com/robinduckett))\n\nRequires `PythonScriptPlugin` (ships with UE 4.26+).\n\nIf you clone this repo to contribute, install [git-lfs](https://git-lfs.com) first - the bundled test project stores `.uasset` / `.umap` via LFS and plain `git clone` will leave them as pointer files.\n\n## Contributing\n\nIssues and pull requests welcome. If an AI agent had to fall back to `execute_python` during your session, it will offer to submit structured feedback automatically — this helps us prioritize which native handlers to add next.\n\n## License\n\nUE-MCP is licensed under the **Business Source License 1.1** with a **commercial license** available for production use outside the Additional Use Grant.\n\n- **Individuals, students, and educational institutions** use UE-MCP free under BUSL-1.1's Additional Use Grant. Each release converts to Apache 2.0 after four years. See [LICENSE](LICENSE).\n- **Game studios, publishers, contract developers, and commercial entities** using UE-MCP in proprietary products, internal pipelines, or paid services require a commercial license. See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) and [ue-mcp.com/pricing](https://ue-mcp.com/pricing).\n\nContributions are accepted under the terms of the Contributor License Agreement. See [CLA.md](CLA.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdb-lyon%2Fue-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdb-lyon%2Fue-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdb-lyon%2Fue-mcp/lists"}