unreal-mcp-proxy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HyunJin Yoo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+# unreal-mcp-proxy
+
+**Flight recorder for [Epic's Unreal MCP](https://dev.epicgames.com/documentation/unreal-engine/unreal-mcp-in-unreal-editor) (UE 5.8+).**
+A transparent local proxy that records every MCP call your AI agent makes to the Unreal
+Editor, an offline single-file viewer to inspect sessions, and a skill that lets the agent
+query its own history.
+
+Unreal Engine 5.8 ships an MCP server inside the editor, so agents like Claude Code and
+Cursor can drive it. What it doesn't ship is any way to see what actually happened:
+the official debugging story is an output-log filter. This fills that gap.
+
+- **Session recording** - every `tools/call` with request/response bodies, timing, and
+  errors, appended to plain JSONL. An observation session survives editor *and* proxy
+  restarts; it only rolls over when you explicitly clear it.
+- **Offline viewer** - one self-contained `viewer.html`. Double-click it, drop a session
+  file in, and you get a thread timeline, a tool-flow graph with call-order replay, and
+  unwrapped request/response views (no `params.arguments.arguments` archaeology, no
+  escaped-JSON-inside-SSE archaeology). The running proxy also serves it live at
+  `/sessions/{id}` with shareable `?call=` deep links.
+- **Agent skill** - `similar-failures`, `tool-stats`, `call-detail`, `annotate`. When a
+  tool call fails, the agent checks whether a past session already diagnosed it, and
+  records new diagnoses for future sessions. Record once, recall always.
+- **Unreal-aware** - unwraps the `call_tool(toolset_name, tool_name, arguments)` envelope,
+  extracts target actors into the flow graph, and normalizes the completion boundary of
+  Unreal's SSE responses (the editor keeps the connection open until keep-alive expires;
+  without this every call looks ~15s slow).
+- Zero runtime dependencies. Secrets in headers/bodies are redacted before anything is
+  written to disk.
+
+![Live session view: thread timeline, tool flow graph, and call list from a real Unreal Editor session](docs/screenshot-session.png)
+
+*A real session against a live UE 5.8 editor. Failed calls break the thread and outline
+their graph nodes; the `A1` badge marks a call carrying an agent annotation.*
+
+![Call detail: an agent annotation on a real schema failure, with the unwrapped request and the raw schema error](docs/screenshot-call-detail.png)
+
+*The failure loop in action: `find_actors` failed against the real schema, the agent
+recorded the diagnosis, and `similar-failures` will recall it in every future session.*
+
+## How it fits together
+
+Epic's Unreal MCP server is not a separate program - **it runs inside the Unreal Editor
+process** and listens over HTTP (default port 35000). This proxy is a separate,
+long-running local process that sits in front of it. Your agent's `.mcp.json` entry is
+just a URL, so "installing" the proxy means pointing that URL at the proxy's port
+instead of the editor's:
+
+```text
+agent (.mcp.json: :35100) ──HTTP──▶ unreal-mcp-proxy (:35100, you run this)
+                                        │ records to data/sessions/*.jsonl
+                                        ▼ HTTP
+                                    Unreal Editor's built-in MCP server (:35000)
+```
+
+Because their lifecycles are independent, the proxy (and its observation session)
+survives editor restarts, and calls made while the editor is down are recorded as
+failures instead of vanishing. Only the *viewer* needs no server - `viewer.html` works
+from a double-click. The proxy itself must be running to record.
+
+## Prerequisites
+
+- **Unreal Engine 5.8+ with the Unreal MCP server enabled** - this proxy does not
+  install or launch it. Follow [Epic's Unreal MCP documentation](https://dev.epicgames.com/documentation/unreal-engine/unreal-mcp-in-unreal-editor),
+  or start the editor with:
+
+  ```text
+  UnrealEditor.exe <project> -ModelContextProtocolStartServer
+  ```
+
+- **Node.js 20+** for the proxy.
+- An MCP client already talking to Unreal MCP (Claude Code, Cursor, MCP Inspector, ...).
+
+## Quick start
+
+1. Run the proxy (keep it running - a separate terminal, or register it as a
+   service/startup task; it is safe to leave up across editor restarts):
+
+   ```bash
+   npx unreal-mcp-proxy
+   # unreal-mcp-proxy listening: http://127.0.0.1:35100/mcp -> http://127.0.0.1:35000/mcp
+   # session: http://127.0.0.1:35100/sessions/<session-id>
+   ```
+
+2. **Change the port in your agent's `.mcp.json`** from the editor's (35000) to the
+   proxy's (35100). If you already had Unreal MCP configured, this is the only edit:
+
+   ```json
+   {
+     "mcpServers": {
+       "unreal-mcp": { "type": "http", "url": "http://127.0.0.1:35100/mcp" }
+     }
+   }
+   ```
+
+3. Work as usual. Open the session URL to watch calls live, or open `viewer.html` and
+   drop a `data/sessions/*.jsonl` file to inspect a recording offline - the viewer
+   needs no server at all.
+
+If your editor's MCP server runs on a non-default port, set
+`UNREAL_MCP_UPSTREAM_URL=http://127.0.0.1:<port>/mcp`.
+
+### Auto-start (no separate terminal)
+
+Don't want to run step 1 by hand every time? Register the proxy as a **stdio** server
+instead - your MCP client then starts it automatically whenever a session connects:
+
+```json
+{
+  "mcpServers": {
+    "unreal-mcp": {
+      "command": "npx",
+      "args": ["unreal-mcp-proxy", "--stdio"]
+    }
+  }
+}
+```
+
+In this mode the spawned process is a thin shim: it checks whether the proxy daemon is
+already running on the configured port, **starts it (detached) if not**, and bridges
+stdio to it. The daemon - and your observation session, live viewer, and sinks - keeps
+running after the client session ends, and every concurrent client shares the same
+recorder. Configure it with the same `UNREAL_MCP_PROXY_*` environment variables (set
+them in the `env` field of the entry if needed).
+
+## Configuration
+
+Environment variables (or a JSON file via `UNREAL_MCP_PROXY_CONFIG`):
+
+| Variable | Default | |
+| --- | --- | --- |
+| `UNREAL_MCP_UPSTREAM_URL` | `http://127.0.0.1:35000/mcp` | The editor's MCP endpoint |
+| `UNREAL_MCP_PROXY_PORT` | `35100` | Proxy listen port |
+| `UNREAL_MCP_PROXY_HOST` | `127.0.0.1` | Bind `0.0.0.0` to share session links on your LAN |
+| `UNREAL_MCP_PROXY_DATA_DIR` | `./data` | Where sessions are recorded |
+
+`POST /api/session/clear` starts a new observation session (history is kept).
+
+## Event sinks (central monitoring)
+
+Recording is local-first, but every event can also be forwarded elsewhere - a team
+server, a log shipper, a queue - through **sinks**. A sink is an ES module the proxy
+loads at startup and feeds every recorded event. Both the module and its settings are
+injected from the config - nothing is hardcoded:
+
+```json
+{
+  "sinks": [
+    { "module": "./team-sink.mjs", "options": { "url": "https://collector.internal/api/v1/events", "token": "..." } }
+  ]
+}
+```
+
+```js
+// team-sink.mjs - forward events to a central collector, resilient to its downtime
+export default function createSink({ config, options, log }) {
+  const queue = [];
+  const timer = setInterval(async () => {
+    if (!queue.length) return;
+    const batch = queue.splice(0, 100);
+    try {
+      await fetch(options.url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          ...(options.token ? { authorization: `Bearer ${options.token}` } : {})
+        },
+        body: JSON.stringify({ events: batch })
+      });
+    } catch {
+      queue.unshift(...batch); // collector down: keep and retry next tick
+    }
+  }, 5000);
+  return {
+    onEvent(event) { queue.push(event); },
+    close() { clearInterval(timer); }
+  };
+}
+```
+
+Sink contract:
+
+- `onEvent(event)` is awaited inside the recording write chain, so a durable sink can
+  persist events in order. A sink that **throws never breaks recording** (errors are
+  swallowed per event). A sink that fails to **load** fails startup - misconfigured
+  monitoring should be visible.
+- `close()` (optional) runs on shutdown.
+- A sink entry is either a plain module string or `{ module, options }`. `options` is
+  passed to the factory verbatim - put collector URLs, tokens, and batch settings there,
+  not in the sink code.
+- `module` accepts relative paths (resolved against the config file's directory),
+  absolute paths, or **bare npm specifiers** - so a team can publish its sink as a
+  private package and inject it: `{ "module": "@myteam/collector-sink", "options": {...} }`.
+  `UNREAL_MCP_PROXY_SINKS` (comma-separated module specifiers) works too.
+- Writing one in TypeScript? `import type { SinkFactory } from "unreal-mcp-proxy"` -
+  the package ships a library entry with all types.
+
+## Agent skill
+
+Copy (or symlink) `skills/unreal-mcp-observer/` into your agent's skill directory
+(for Claude Code: `.claude/skills/`). The skill teaches the agent to:
+
+1. check `similar-failures` before retrying a failed Unreal tool call - past sessions may
+   have already recorded the root cause and fix (asset read-only under LFS locking, etc.),
+2. compare slow calls against recorded `tool-stats` baselines,
+3. `annotate` new diagnoses so they are recalled forever after.
+
+The query CLI also works standalone:
+
+```bash
+node skills/unreal-mcp-observer/scripts/query.mjs recent-failures
+node skills/unreal-mcp-observer/scripts/query.mjs similar-failures "as it is read only"
+```
+
+## API
+
+| Route | |
+| --- | --- |
+| `POST /mcp` | Transparent MCP forwarding (this is what agents talk to) |
+| `GET /health` | Proxy + active session status |
+| `GET /api/session` · `POST /api/session/clear` | Active observation session |
+| `GET /api/sessions/{id}` | Session model (calls, graph, annotations) |
+| `GET /api/sessions/{id}/events` | Raw recorded events |
+| `GET /api/sessions/{id}/stream` | SSE change stream |
+| `POST /api/sessions/{id}/annotations` | Attach a diagnosis to a call |
+| `GET /sessions/{id}` · `GET /viewer` | Viewer (served mode) |
+
+## Development
+
+TypeScript throughout. Node 20+ to run; Node 24+ to develop (tests run `.ts` natively).
+
+```bash
+npm install
+npm run build       # tsc -> dist, viewer -> dist/viewer.html
+npm test
+npm run typecheck
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig } from "./config.js";
+import { SessionStore } from "./session-store.js";
+import { createProxyServer } from "./proxy-server.js";
+import { loadSinks, closeSinks } from "./sinks.js";
+import { runStdioBridge } from "./stdio-bridge.js";
+const config = await loadConfig();
+// stdio mode: MCP clients spawn this per session; it ensures the HTTP daemon and bridges stdio to it.
+if (process.argv.includes("--stdio")) {
+    await runStdioBridge(config);
+    process.exit(0);
+}
+const store = new SessionStore(config.dataDir, config.webBaseUrl);
+await store.initialize();
+const sinks = await loadSinks(store, config, (message) => console.log(message));
+const viewerPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "viewer.html");
+const server = createProxyServer(config, store, { viewerPath });
+server.listen(config.listenPort, config.listenHost, async () => {
+    await store.append("proxy_started", {
+        listenUrl: `http://${config.listenHost}:${config.listenPort}/mcp`,
+        upstreamUrl: config.upstreamUrl,
+        processId: process.pid
+    });
+    console.log(`unreal-mcp-proxy listening: http://${config.listenHost}:${config.listenPort}/mcp -> ${config.upstreamUrl}`);
+    console.log(`session: ${store.describe().url}`);
+});
+async function shutdown(signal) {
+    await store.append("proxy_stopping", { signal });
+    await closeSinks(sinks);
+    server.close(() => process.exit(0));
+    setTimeout(() => process.exit(0), 2000).unref();
+}
+process.on("SIGINT", () => void shutdown("SIGINT"));
+process.on("SIGTERM", () => void shutdown("SIGTERM"));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;AAElC,sGAAsG;AACtG,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;IACrC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAClE,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;AACzB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAEhF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AAC7F,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;IAC7D,MAAM,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE;QAClC,SAAS,EAAE,UAAU,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,MAAM;QACjE,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,OAAO,CAAC,GAAG;KACvB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,sCAAsC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACzH,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,MAAM,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+import type { RedactionConfig } from "./redaction.js";
+import type { SinkSpec } from "./sinks.js";
+export interface ProxyConfig {
+    listenHost: string;
+    listenPort: number;
+    upstreamUrl: string;
+    dataDir: string;
+    webBaseUrl: string;
+    redaction: RedactionConfig;
+    /** Event sinks (docs: README "Event sinks"): a module path/specifier, or { module, options }. */
+    sinks: SinkSpec[];
+    /** Directory sink paths resolve against: the config file's directory, or cwd. */
+    baseDir: string;
+}
+export declare function loadConfig(configPath?: string | undefined): Promise<ProxyConfig>;

package/dist/config.js

@@ -0,0 +1,51 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+const defaults = {
+    listenHost: "127.0.0.1",
+    listenPort: 35100,
+    // Epic's Unreal MCP default: UnrealEditor -ModelContextProtocolStartServer (port 35000)
+    upstreamUrl: "http://127.0.0.1:35000/mcp",
+    dataDir: "./data",
+    webBaseUrl: "",
+    redaction: {
+        headers: ["authorization", "cookie", "set-cookie", "x-api-key"],
+        jsonKeys: ["token", "password", "secret", "apiKey", "authorization"],
+        maxBodyBytes: 262144
+    },
+    sinks: [],
+    baseDir: ""
+};
+function merge(base, override) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override ?? {})) {
+        if (value === undefined)
+            continue;
+        const current = result[key];
+        result[key] = value && typeof value === "object" && !Array.isArray(value)
+            ? merge((current ?? {}), value)
+            : value;
+    }
+    return result;
+}
+export async function loadConfig(configPath = process.env.UNREAL_MCP_PROXY_CONFIG) {
+    let config = defaults;
+    if (configPath) {
+        config = merge(config, JSON.parse(await readFile(configPath, "utf8")));
+    }
+    config = merge(config, {
+        listenHost: process.env.UNREAL_MCP_PROXY_HOST,
+        listenPort: process.env.UNREAL_MCP_PROXY_PORT ? Number(process.env.UNREAL_MCP_PROXY_PORT) : undefined,
+        upstreamUrl: process.env.UNREAL_MCP_UPSTREAM_URL,
+        dataDir: process.env.UNREAL_MCP_PROXY_DATA_DIR,
+        webBaseUrl: process.env.UNREAL_MCP_PROXY_WEB_BASE_URL,
+        sinks: process.env.UNREAL_MCP_PROXY_SINKS
+            ? process.env.UNREAL_MCP_PROXY_SINKS.split(",").map((entry) => entry.trim()).filter(Boolean)
+            : undefined
+    });
+    config.dataDir = path.resolve(config.dataDir);
+    config.baseDir = configPath ? path.dirname(path.resolve(configPath)) : process.cwd();
+    if (!config.webBaseUrl)
+        config.webBaseUrl = `http://127.0.0.1:${config.listenPort}`;
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/** Library entry: embed the recorder or write custom sinks against these APIs. */
+export { loadConfig, type ProxyConfig } from "./config.js";
+export { SessionStore, type SessionStoreOptions, type EventListener } from "./session-store.js";
+export { createProxyServer, type ProxyServerOptions } from "./proxy-server.js";
+export { buildSessionModel, normalizeError } from "./session-model.js";
+export { loadSinks, closeSinks, type Sink, type SinkFactory, type SinkContext, type SinkSpec } from "./sinks.js";
+export { runStdioBridge, ensureDaemon } from "./stdio-bridge.js";
+export { redactHeaders, redactValue, summarizeBody, type RedactionConfig } from "./redaction.js";
+export type * from "./types.js";

package/dist/index.js

@@ -0,0 +1,9 @@
+/** Library entry: embed the recorder or write custom sinks against these APIs. */
+export { loadConfig } from "./config.js";
+export { SessionStore } from "./session-store.js";
+export { createProxyServer } from "./proxy-server.js";
+export { buildSessionModel, normalizeError } from "./session-model.js";
+export { loadSinks, closeSinks } from "./sinks.js";
+export { runStdioBridge, ensureDaemon } from "./stdio-bridge.js";
+export { redactHeaders, redactValue, summarizeBody } from "./redaction.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAA2B,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAgE,MAAM,YAAY,CAAC;AACjH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAwB,MAAM,gBAAgB,CAAC"}

package/dist/proxy-server.d.ts

@@ -0,0 +1,8 @@
+import { type Server } from "node:http";
+import type { ProxyConfig } from "./config.js";
+import type { SessionStore } from "./session-store.js";
+export interface ProxyServerOptions {
+    /** Path to the built single-file viewer HTML. Served at /sessions/{id} and /viewer. */
+    viewerPath?: string;
+}
+export declare function createProxyServer(config: ProxyConfig, store: SessionStore, options?: ProxyServerOptions): Server;