@openfairygui/mcp 0.2.0-alpha.0 → 0.2.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenFairyGUI Contributors
+
+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/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-BDHxauin.cjs");
+const require_stdio = require("./stdio-Ckmxm29z.cjs");
 exports.OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI = require_stdio.OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI;
 exports.OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = require_stdio.OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS;
 exports.OPENFAIRYGUI_BACKEND_PROMPT_NAMES = require_stdio.OPENFAIRYGUI_BACKEND_PROMPT_NAMES;

package/dist/index.d.cts

@@ -14,9 +14,9 @@ declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServ
 //#endregion
 //#region src/tool-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
-declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_get_session", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
+declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_open_project_session", "openfairygui_backend_get_session", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
 type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_NAMES[number];
-type BackendMethodName = 'getCapabilities' | 'openSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -79,6 +79,30 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     readonly idempotentHint: false;
     readonly openWorldHint: false;
   };
+}, {
+  readonly name: "openfairygui_backend_open_project_session";
+  readonly backendMethod: "openProjectSession";
+  readonly title: "Open Project Session";
+  readonly description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.";
+  readonly inputSchema: z.ZodObject<{
+    project: z.ZodUnknown;
+    sessionId: z.ZodOptional<z.ZodString>;
+    canonicalProjectPath: z.ZodOptional<z.ZodString>;
+    canonicalPathKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  readonly outputSchema: z.ZodObject<{
+    backendResult: z.ZodObject<{
+      ok: z.ZodBoolean;
+      data: z.ZodOptional<z.ZodUnknown>;
+      error: z.ZodOptional<z.ZodUnknown>;
+      meta: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+  }, z.core.$strip>;
+  readonly annotations: {
+    readonly readOnlyHint: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+  };
 }, {
   readonly name: "openfairygui_backend_get_session";
   readonly backendMethod: "getSession";

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { connectOpenFairyGuiMcpStdio } from "./stdio.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { BackendRuntime } from "@openfairygui/backend";
 import { z } from "zod";
+import { BackendRuntime } from "@openfairygui/backend";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 
 //#region src/server.d.ts
@@ -14,9 +14,9 @@ declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServ
 //#endregion
 //#region src/tool-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
-declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_get_session", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
+declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_open_project_session", "openfairygui_backend_get_session", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
 type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_NAMES[number];
-type BackendMethodName = 'getCapabilities' | 'openSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -79,6 +79,30 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     readonly idempotentHint: false;
     readonly openWorldHint: false;
   };
+}, {
+  readonly name: "openfairygui_backend_open_project_session";
+  readonly backendMethod: "openProjectSession";
+  readonly title: "Open Project Session";
+  readonly description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.";
+  readonly inputSchema: z.ZodObject<{
+    project: z.ZodUnknown;
+    sessionId: z.ZodOptional<z.ZodString>;
+    canonicalProjectPath: z.ZodOptional<z.ZodString>;
+    canonicalPathKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  readonly outputSchema: z.ZodObject<{
+    backendResult: z.ZodObject<{
+      ok: z.ZodBoolean;
+      data: z.ZodOptional<z.ZodUnknown>;
+      error: z.ZodOptional<z.ZodUnknown>;
+      meta: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+  }, z.core.$strip>;
+  readonly annotations: {
+    readonly readOnlyHint: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+  };
 }, {
   readonly name: "openfairygui_backend_get_session";
   readonly backendMethod: "getSession";

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA, c as OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, d as OPENFAIRYGUI_BACKEND_PROMPT_NAMES, i as OPENFAIRYGUI_BACKEND_TOOL_NAMES, l as OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, n as createOpenFairyGuiMcpServer, o as OPENFAIRYGUI_BACKEND_TOOL_PREFIX, r as OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, s as callOpenFairyGuiBackendTool, t as connectOpenFairyGuiMcpStdio, u as OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS } from "./stdio-ByGWerIG.mjs";
+import { a as OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA, c as OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, d as OPENFAIRYGUI_BACKEND_PROMPT_NAMES, i as OPENFAIRYGUI_BACKEND_TOOL_NAMES, l as OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, n as createOpenFairyGuiMcpServer, o as OPENFAIRYGUI_BACKEND_TOOL_PREFIX, r as OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, s as callOpenFairyGuiBackendTool, t as connectOpenFairyGuiMcpStdio, u as OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS } from "./stdio-DT1cUPJ3.mjs";
 export { OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS, OPENFAIRYGUI_BACKEND_PROMPT_NAMES, OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, OPENFAIRYGUI_BACKEND_TOOL_NAMES, OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA, OPENFAIRYGUI_BACKEND_TOOL_PREFIX, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer };

package/dist/{stdio-BDHxauin.cjs → stdio-Ckmxm29z.cjs}

@@ -1,5 +1,5 @@
 let _modelcontextprotocol_sdk_server_mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
-let _openfairygui_backend = require("@openfairygui/backend");
+let _openfairygui_backend_node = require("@openfairygui/backend/node");
 let zod = require("zod");
 let _modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
 let node_url = require("node:url");
@@ -148,6 +148,14 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 		case "openfairygui_backend_open_session":
 			result = await runtime.openSession({ projectPath: String(input.projectPath) });
 			break;
+		case "openfairygui_backend_open_project_session":
+			result = runtime.openProjectSession({
+				project: input.project,
+				sessionId: input.sessionId === void 0 ? void 0 : String(input.sessionId),
+				canonicalProjectPath: input.canonicalProjectPath === void 0 ? void 0 : String(input.canonicalProjectPath),
+				canonicalPathKey: input.canonicalPathKey === void 0 ? void 0 : String(input.canonicalPathKey)
+			});
+			break;
 		case "openfairygui_backend_get_session":
 			result = runtime.getSession({ sessionId: String(input.sessionId) });
 			break;
@@ -214,6 +222,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
 const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"openfairygui_backend_get_capabilities",
 	"openfairygui_backend_open_session",
+	"openfairygui_backend_open_project_session",
 	"openfairygui_backend_get_session",
 	"openfairygui_backend_apply_transaction",
 	"openfairygui_backend_save_session",
@@ -262,6 +271,24 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			openWorldHint: false
 		}
 	},
+	{
+		name: "openfairygui_backend_open_project_session",
+		backendMethod: "openProjectSession",
+		title: "Open Project Session",
+		description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.",
+		inputSchema: zod.z.object({
+			project: zod.z.unknown(),
+			sessionId: zod.z.string().min(1).optional(),
+			canonicalProjectPath: zod.z.string().min(1).optional(),
+			canonicalPathKey: zod.z.string().min(1).optional()
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: false,
+			idempotentHint: false,
+			openWorldHint: false
+		}
+	},
 	{
 		name: "openfairygui_backend_get_session",
 		backendMethod: "getSession",
@@ -437,7 +464,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 //#region src/server.ts
 const PACKAGE_VERSION = process.env.npm_package_version ?? "0.2.0-alpha.0";
 function createOpenFairyGuiMcpServer(options = {}) {
-	const runtime = options.runtime ?? new _openfairygui_backend.BackendRuntime();
+	const runtime = options.runtime ?? (0, _openfairygui_backend_node.createNodeBackendRuntime)();
 	const server = new _modelcontextprotocol_sdk_server_mcp_js.McpServer({
 		name: options.name ?? "openfairygui-mcp",
 		version: options.version ?? PACKAGE_VERSION

package/dist/{stdio-ByGWerIG.mjs → stdio-DT1cUPJ3.mjs}

@@ -1,5 +1,5 @@
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { BackendRuntime } from "@openfairygui/backend";
+import { createNodeBackendRuntime } from "@openfairygui/backend/node";
 import { z } from "zod";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { pathToFileURL } from "node:url";
@@ -148,6 +148,14 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 		case "openfairygui_backend_open_session":
 			result = await runtime.openSession({ projectPath: String(input.projectPath) });
 			break;
+		case "openfairygui_backend_open_project_session":
+			result = runtime.openProjectSession({
+				project: input.project,
+				sessionId: input.sessionId === void 0 ? void 0 : String(input.sessionId),
+				canonicalProjectPath: input.canonicalProjectPath === void 0 ? void 0 : String(input.canonicalProjectPath),
+				canonicalPathKey: input.canonicalPathKey === void 0 ? void 0 : String(input.canonicalPathKey)
+			});
+			break;
 		case "openfairygui_backend_get_session":
 			result = runtime.getSession({ sessionId: String(input.sessionId) });
 			break;
@@ -214,6 +222,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
 const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"openfairygui_backend_get_capabilities",
 	"openfairygui_backend_open_session",
+	"openfairygui_backend_open_project_session",
 	"openfairygui_backend_get_session",
 	"openfairygui_backend_apply_transaction",
 	"openfairygui_backend_save_session",
@@ -262,6 +271,24 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			openWorldHint: false
 		}
 	},
+	{
+		name: "openfairygui_backend_open_project_session",
+		backendMethod: "openProjectSession",
+		title: "Open Project Session",
+		description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.",
+		inputSchema: z.object({
+			project: z.unknown(),
+			sessionId: z.string().min(1).optional(),
+			canonicalProjectPath: z.string().min(1).optional(),
+			canonicalPathKey: z.string().min(1).optional()
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: false,
+			idempotentHint: false,
+			openWorldHint: false
+		}
+	},
 	{
 		name: "openfairygui_backend_get_session",
 		backendMethod: "getSession",
@@ -437,7 +464,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 //#region src/server.ts
 const PACKAGE_VERSION = process.env.npm_package_version ?? "0.2.0-alpha.0";
 function createOpenFairyGuiMcpServer(options = {}) {
-	const runtime = options.runtime ?? new BackendRuntime();
+	const runtime = options.runtime ?? createNodeBackendRuntime();
 	const server = new McpServer({
 		name: options.name ?? "openfairygui-mcp",
 		version: options.version ?? PACKAGE_VERSION

package/dist/stdio.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-BDHxauin.cjs");
+const require_stdio = require("./stdio-Ckmxm29z.cjs");
 exports.connectOpenFairyGuiMcpStdio = require_stdio.connectOpenFairyGuiMcpStdio;

package/dist/stdio.mjs

@@ -1,2 +1,2 @@
-import { t as connectOpenFairyGuiMcpStdio } from "./stdio-ByGWerIG.mjs";
+import { t as connectOpenFairyGuiMcpStdio } from "./stdio-DT1cUPJ3.mjs";
 export { connectOpenFairyGuiMcpStdio };

package/package.json

@@ -1,85 +1,85 @@
 {
-	"name": "@openfairygui/mcp",
-	"version": "0.2.0-alpha.0",
-	"description": "FairyGUI Headless Authoring SDK - MCP server adapter for the backend runtime.",
-	"author": "OpenFairyGUI Contributors",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/OpenFairyGUI/OpenFairyGUI.git",
-		"directory": "packages/mcp"
-	},
-	"homepage": "https://github.com/OpenFairyGUI/OpenFairyGUI#readme",
-	"bugs": {
-		"url": "https://github.com/OpenFairyGUI/OpenFairyGUI/issues"
-	},
-	"type": "module",
-	"sideEffects": false,
-	"main": "./dist/index.cjs",
-	"module": "./dist/index.mjs",
-	"types": "./dist/index.d.mts",
-	"exports": {
-		".": {
-			"require": {
-				"types": "./dist/index.d.cts",
-				"default": "./dist/index.cjs"
-			},
-			"default": {
-				"types": "./dist/index.d.mts",
-				"default": "./dist/index.mjs"
-			}
-		},
-		"./stdio": {
-			"require": {
-				"types": "./dist/stdio.d.cts",
-				"default": "./dist/stdio.cjs"
-			},
-			"default": {
-				"types": "./dist/stdio.d.mts",
-				"default": "./dist/stdio.mjs"
-			}
-		}
-	},
-	"bin": {
-		"ofgui-mcp": "bin/ofgui-mcp.cjs"
-	},
-	"scripts": {
-		"build": "tsdown src/index.ts src/stdio.ts --format esm,cjs --platform node --external node:fs --external node:path --external node:fs/promises --env.PACKAGE_VERSION=$npm_package_version",
-		"build:watch": "tsdown src/index.ts src/stdio.ts --watch --format esm,cjs --platform node --env.PACKAGE_VERSION=$npm_package_version",
-		"test": "ava test/**/*.test.ts --no-worker-threads"
-	},
-	"files": [
-		"dist/",
-		"bin/",
-		"src/"
-	],
-	"keywords": [
-		"fairygui",
-		"mcp",
-		"model-context-protocol",
-		"backend",
-		"authoring"
-	],
-	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.29.0",
-		"@openfairygui/backend": "workspace:*",
-		"zod": "^4.3.6"
-	},
-	"devDependencies": {
-		"@openfairygui/core": "workspace:*",
-		"ava": "^7.0.0",
-		"tsx": "^4.0.0"
-	},
-	"ava": {
-		"extensions": {
-			"ts": "module"
-		},
-		"nodeArguments": [
-			"--import",
-			"tsx/esm"
-		],
-		"files": [
-			"test/**/*.test.ts"
-		]
-	}
-}
+  "name": "@openfairygui/mcp",
+  "version": "0.2.0-alpha.2",
+  "description": "FairyGUI Headless Authoring SDK - MCP server adapter for the backend runtime.",
+  "author": "OpenFairyGUI Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenFairyGUI/OpenFairyGUI.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/OpenFairyGUI/OpenFairyGUI#readme",
+  "bugs": {
+    "url": "https://github.com/OpenFairyGUI/OpenFairyGUI/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./stdio": {
+      "require": {
+        "types": "./dist/stdio.d.cts",
+        "default": "./dist/stdio.cjs"
+      },
+      "default": {
+        "types": "./dist/stdio.d.mts",
+        "default": "./dist/stdio.mjs"
+      }
+    }
+  },
+  "bin": {
+    "ofgui-mcp": "bin/ofgui-mcp.cjs"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "src/"
+  ],
+  "keywords": [
+    "fairygui",
+    "mcp",
+    "model-context-protocol",
+    "backend",
+    "authoring"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6",
+    "@openfairygui/backend": "0.2.0-alpha.2"
+  },
+  "devDependencies": {
+    "ava": "^7.0.0",
+    "tsx": "^4.0.0",
+    "@openfairygui/core": "0.2.0-alpha.2"
+  },
+  "ava": {
+    "extensions": {
+      "ts": "module"
+    },
+    "nodeArguments": [
+      "--import",
+      "tsx/esm"
+    ],
+    "files": [
+      "test/**/*.test.ts"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/stdio.ts --format esm,cjs --platform node --external node:fs --external node:path --external node:fs/promises --env.PACKAGE_VERSION=$npm_package_version",
+    "build:watch": "tsdown src/index.ts src/stdio.ts --watch --format esm,cjs --platform node --env.PACKAGE_VERSION=$npm_package_version",
+    "test": "ava test/**/*.test.ts --no-worker-threads"
+  }
+}

package/src/server.ts

@@ -1,5 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { BackendRuntime } from '@openfairygui/backend';
+import type { BackendRuntime } from '@openfairygui/backend';
+import { createNodeBackendRuntime } from '@openfairygui/backend/node';
 import { registerOpenFairyGuiBackendPrompts } from './prompt-definitions.js';
 import { registerOpenFairyGuiBackendResources } from './resource-definitions.js';
 import { callOpenFairyGuiBackendTool } from './tool-handler.js';
@@ -17,7 +18,7 @@ export interface CreateOpenFairyGuiMcpServerOptions {
 }
 
 export function createOpenFairyGuiMcpServer(options: CreateOpenFairyGuiMcpServerOptions = {}): McpServer {
-	const runtime = options.runtime ?? new BackendRuntime();
+	const runtime = options.runtime ?? createNodeBackendRuntime();
 	const server = new McpServer({
 		name: options.name ?? 'openfairygui-mcp',
 		version: options.version ?? PACKAGE_VERSION,

package/src/tool-definitions.ts

@@ -5,6 +5,7 @@ export const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = 'openfairygui_backend_';
 export const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	'openfairygui_backend_get_capabilities',
 	'openfairygui_backend_open_session',
+	'openfairygui_backend_open_project_session',
 	'openfairygui_backend_get_session',
 	'openfairygui_backend_apply_transaction',
 	'openfairygui_backend_save_session',
@@ -22,6 +23,7 @@ export type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_NAMES
 export type BackendMethodName =
 	| 'getCapabilities'
 	| 'openSession'
+	| 'openProjectSession'
 	| 'getSession'
 	| 'applyTransaction'
 	| 'saveSession'
@@ -83,6 +85,20 @@ export const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
 	},
+	{
+		name: 'openfairygui_backend_open_project_session',
+		backendMethod: 'openProjectSession',
+		title: 'Open Project Session',
+		description: 'Open a browser-safe backend session from an already loaded UAM project without filesystem access.',
+		inputSchema: z.object({
+			project: z.unknown(),
+			sessionId: z.string().min(1).optional(),
+			canonicalProjectPath: z.string().min(1).optional(),
+			canonicalPathKey: z.string().min(1).optional(),
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
+	},
 	{
 		name: 'openfairygui_backend_get_session',
 		backendMethod: 'getSession',

package/src/tool-handler.ts

@@ -39,6 +39,14 @@ export async function callOpenFairyGuiBackendTool(
 				projectPath: String(input.projectPath),
 			});
 			break;
+		case 'openfairygui_backend_open_project_session':
+			result = runtime.openProjectSession({
+				project: input.project as Parameters<BackendRuntime['openProjectSession']>[0]['project'],
+				sessionId: input.sessionId === undefined ? undefined : String(input.sessionId),
+				canonicalProjectPath: input.canonicalProjectPath === undefined ? undefined : String(input.canonicalProjectPath),
+				canonicalPathKey: input.canonicalPathKey === undefined ? undefined : String(input.canonicalPathKey),
+			});
+			break;
 		case 'openfairygui_backend_get_session':
 			result = runtime.getSession({
 				sessionId: String(input.sessionId),