Skip to main content
Glama
azereki

ue-angelscript-mcp

by azereki
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

ue-angelscript-mcp

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

Tool

Description

Requires

as_get_context

Query AS documentation by category or keyword

Nothing

as_list_scripts

List .as files in project script directories

Project path

as_read_script

Read a script file with optional line range

Project path

as_search_scripts

Regex search across all .as files

Project path

as_find_cpp_binding

Grep engine C++ source for Angelscript binds (e.g. METHOD, FUNC)

Engine path

as_check_script_errors

Check the latest Unreal Engine log for script compilation errors

Project path

as_scaffold

Generate idiomatic boilerplate for AS classes (Actors, Widgets, etc.)

Nothing

as_scan_definitions

Parse a script file for AST definitions (classes, structs, functions)

Project path

as_find_usages

Search across all .as files for usages of an identifier

Project path

as_run_tests

Run Angelscript unit tests via commandlet

Project path + editor binary

as_build_engine

Trigger UnrealBuildTool to compile the project or engine

Engine path

as_task_status

Check the status of a running background task

Nothing

as_task_list

List all background tasks

Nothing

as_editor_status

Ping the Python Editor Bridge

Editor Bridge

as_get_level_actors

Get all actors in the current level

Editor Bridge

as_execute_python

Execute arbitrary Python code inside the Editor

Editor Bridge

as_execute_snippet

Compile and execute a snippet of Angelscript in the Editor

Editor Bridge

as_spawn_actor

Spawn an actor from a class path at a location

Editor Bridge

as_focus_viewport

Focus the Editor camera on an actor or location

Editor Bridge

as_get_script_roots

List script root directories

Nothing (enhanced with editor)

as_project_info

Project overview with configuration status

Nothing

Related MCP server: Adastrea-MCP

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:

Variable

Description

UE_AS_PROJECT_PATH

Path to UE project root

UE_AS_EDITOR_CMD

Path to UnrealEditor-Cmd binary

UE_AS_EXTRA_SCRIPT_ROOTS

Additional script directories (semicolon-separated)

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:

Category

Covers

scripting_basics

Actors, components, UCLASS, UFUNCTION, BeginPlay

language_fundamentals

Types, containers, handles, casting, lambdas

properties_events

UPROPERTY specifiers, delegates, timers, input

networking

Replication, RPCs, net roles, authority

testing

Unit tests, integration tests, latent commands

bindings

C++ bindings, FUNC/METHOD macros, ScriptMixin

advanced_features

Hot reload, preprocessor, GAS, subsystems

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.

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

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • ue-codegraph-mcp

    YomenStyle
    F
    license
    A
    quality
    C
    maintenance
    An MCP server for indexing and querying Unreal Engine C++ codebases using a local SQLite database. It enables users to analyze call graphs, class structures, and Blueprint-exposed symbols through tools integrated with Claude Code.
    16
    -

  • Adastrea-MCP

    Mittenzx
    F
    license
    B
    quality
    D
    maintenance
    MCP server for managing Adastrea game project information and Unreal Engine integration, enabling AI agents to store, retrieve, and manage comprehensive game development details.
    44
    1
    -