Ue Angelscript

MCP server for Unreal Engine Angelscript development. Provides documentation lookup, script file management, and test running through Claude Code or any MCP-compatible client.

Built for the UE-AS engine fork by Hazelight Studios.

Tools

Install

git clone https://github.com/azereki/ue-angelscript-mcp.git
cd ue-angelscript-mcp
npm install
npm link

npm install automatically builds via the prepare script.

Configure

Add to your project's .mcp.json:

{
  "mcpServers": {
    "ue-angelscript": {
      "command": "ue-angelscript-mcp"
    }
  }
}

That's it. The server auto-detects your project from the working directory.

Auto-detection

The server walks upward from cwd to find your project:

1. Game project — directory containing a .uproject file
2. Engine source tree — directory containing Engine/Plugins/Angelscript/

Once the project root is found, the editor binary is located automatically at Engine/Binaries/{platform}/UnrealEditor-Cmd.

Environment variable overrides

For non-standard layouts, set these in the .mcp.json env block or your shell:

Example with overrides:

{
  "mcpServers": {
    "ue-angelscript": {
      "command": "ue-angelscript-mcp",
      "env": {
        "UE_AS_PROJECT_PATH": "/path/to/my/project",
        "UE_AS_EXTRA_SCRIPT_ROOTS": "/shared/scripts;/mods/scripts"
      }
    }
  }
}

Documentation categories

as_get_context organizes 2,700+ lines of bundled reference docs into searchable categories:

Call with no arguments to see all categories. Use category for browsing or query for keyword search.

Development

npm run dev     # Watch mode (recompiles on save)
npm run build   # One-time build
npm start       # Run the server directly

Test interactively with MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Attribution & Acknowledgments

This project incorporates architectural patterns (specifically the Async Task Queue and the Python Editor Bridge) adapted from the excellent UE5 MCP Server.

• Project: UE5 MCP Server
• Author: Natali Caggiano (Natfii)
• Link: https://github.com/Natfii/unrealclaude-mcp-bridge

See THIRD-PARTY-NOTICES.txt for full license details.

License

MIT