@satelliteoflove/godot-mcp 0.1.0

package/dist/tools/node.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { defineTool } from '../core/define-tool.js';
+export const getNodeProperties = defineTool({
+    name: 'get_node_properties',
+    description: 'Get all properties of a node at the specified path',
+    schema: z.object({
+        node_path: z
+            .string()
+            .describe('Path to the node (e.g., "/root/Main/Player")'),
+    }),
+    async execute({ node_path }, { godot }) {
+        const result = await godot.sendCommand('get_node_properties', { node_path });
+        return JSON.stringify(result.properties, null, 2);
+    },
+});
+export const createNode = defineTool({
+    name: 'create_node',
+    description: 'Create a new node as a child of an existing node',
+    schema: z.object({
+        parent_path: z.string().describe('Path to the parent node'),
+        node_type: z
+            .string()
+            .describe('Type of node to create (e.g., "Sprite2D", "CharacterBody2D")'),
+        node_name: z.string().describe('Name for the new node'),
+        properties: z
+            .record(z.unknown())
+            .optional()
+            .describe('Optional properties to set on the node'),
+    }),
+    async execute({ parent_path, node_type, node_name, properties }, { godot }) {
+        const result = await godot.sendCommand('create_node', {
+            parent_path,
+            node_type,
+            node_name,
+            properties: properties ?? {},
+        });
+        return `Created node: ${result.node_path}`;
+    },
+});
+export const updateNode = defineTool({
+    name: 'update_node',
+    description: 'Update properties of an existing node',
+    schema: z.object({
+        node_path: z.string().describe('Path to the node to update'),
+        properties: z
+            .record(z.unknown())
+            .describe('Properties to update (key-value pairs)'),
+    }),
+    async execute({ node_path, properties }, { godot }) {
+        await godot.sendCommand('update_node', { node_path, properties });
+        return `Updated node: ${node_path}`;
+    },
+});
+export const deleteNode = defineTool({
+    name: 'delete_node',
+    description: 'Delete a node from the scene',
+    schema: z.object({
+        node_path: z.string().describe('Path to the node to delete'),
+    }),
+    async execute({ node_path }, { godot }) {
+        await godot.sendCommand('delete_node', { node_path });
+        return `Deleted node: ${node_path}`;
+    },
+});
+export const reparentNode = defineTool({
+    name: 'reparent_node',
+    description: 'Move a node to a new parent',
+    schema: z.object({
+        node_path: z.string().describe('Path to the node to move'),
+        new_parent_path: z.string().describe('Path to the new parent node'),
+    }),
+    async execute({ node_path, new_parent_path }, { godot }) {
+        await godot.sendCommand('reparent_node', { node_path, new_parent_path });
+        return `Moved node ${node_path} to ${new_parent_path}`;
+    },
+});
+export const nodeTools = [
+    getNodeProperties,
+    createNode,
+    updateNode,
+    deleteNode,
+    reparentNode,
+];
+//# sourceMappingURL=node.js.map

package/dist/tools/node.js.map

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

package/dist/tools/project.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { AnyToolDefinition } from '../core/types.js';
+export declare const getProjectInfo: import("../core/types.js").ToolDefinition<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+export declare const listProjectFiles: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    file_type: z.ZodEnum<["scripts", "scenes", "resources", "images", "audio", "all"]>;
+    directory: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    file_type: "scripts" | "scenes" | "resources" | "images" | "audio" | "all";
+    directory?: string | undefined;
+    recursive?: boolean | undefined;
+}, {
+    file_type: "scripts" | "scenes" | "resources" | "images" | "audio" | "all";
+    directory?: string | undefined;
+    recursive?: boolean | undefined;
+}>>;
+export declare const searchFiles: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    pattern: z.ZodString;
+    directory: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    directory?: string | undefined;
+}, {
+    pattern: string;
+    directory?: string | undefined;
+}>>;
+export declare const getProjectSettings: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+}, {
+    category?: string | undefined;
+}>>;
+export declare const projectTools: AnyToolDefinition[];
+//# sourceMappingURL=project.d.ts.map

package/dist/tools/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/tools/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,cAAc,2FAazB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;GAgC3B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;GAmBtB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;GAe7B,CAAC;AAEH,eAAO,MAAM,YAAY,EAKpB,iBAAiB,EAAE,CAAC"}

package/dist/tools/project.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { defineTool } from '../core/define-tool.js';
+export const getProjectInfo = defineTool({
+    name: 'get_project_info',
+    description: 'Get information about the current Godot project',
+    schema: z.object({}),
+    async execute(_, { godot }) {
+        const result = await godot.sendCommand('get_project_info');
+        return JSON.stringify(result, null, 2);
+    },
+});
+export const listProjectFiles = defineTool({
+    name: 'list_project_files',
+    description: 'List files in the project by type',
+    schema: z.object({
+        file_type: z
+            .enum(['scripts', 'scenes', 'resources', 'images', 'audio', 'all'])
+            .describe('Type of files to list'),
+        directory: z
+            .string()
+            .optional()
+            .describe('Optional directory to search in (defaults to "res://")'),
+        recursive: z
+            .boolean()
+            .optional()
+            .describe('Whether to search recursively (defaults to true)'),
+    }),
+    async execute({ file_type, directory, recursive }, { godot }) {
+        const result = await godot.sendCommand('list_project_files', {
+            file_type,
+            directory: directory ?? 'res://',
+            recursive: recursive ?? true,
+        });
+        if (result.files.length === 0) {
+            return `No ${file_type} files found`;
+        }
+        return `Found ${result.files.length} ${file_type} file(s):\n${result.files.map((f) => `  - ${f}`).join('\n')}`;
+    },
+});
+export const searchFiles = defineTool({
+    name: 'search_files',
+    description: 'Search for files by name pattern',
+    schema: z.object({
+        pattern: z.string().describe('Search pattern (supports * wildcard)'),
+        directory: z.string().optional().describe('Optional directory to search in'),
+    }),
+    async execute({ pattern, directory }, { godot }) {
+        const result = await godot.sendCommand('search_files', {
+            pattern,
+            directory: directory ?? 'res://',
+        });
+        if (result.files.length === 0) {
+            return `No files matching "${pattern}" found`;
+        }
+        return `Found ${result.files.length} file(s) matching "${pattern}":\n${result.files.map((f) => `  - ${f}`).join('\n')}`;
+    },
+});
+export const getProjectSettings = defineTool({
+    name: 'get_project_settings',
+    description: 'Get project settings',
+    schema: z.object({
+        category: z
+            .string()
+            .optional()
+            .describe('Optional settings category to filter by'),
+    }),
+    async execute({ category }, { godot }) {
+        const result = await godot.sendCommand('get_project_settings', { category });
+        return JSON.stringify(result.settings, null, 2);
+    },
+});
+export const projectTools = [
+    getProjectInfo,
+    listProjectFiles,
+    searchFiles,
+    getProjectSettings,
+];
+//# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

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

package/dist/tools/scene.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import type { AnyToolDefinition } from '../core/types.js';
+export declare const getSceneTree: import("../core/types.js").ToolDefinition<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+export declare const openScene: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    scene_path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scene_path: string;
+}, {
+    scene_path: string;
+}>>;
+export declare const saveScene: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+}, {
+    path?: string | undefined;
+}>>;
+export declare const createScene: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    root_type: z.ZodString;
+    root_name: z.ZodOptional<z.ZodString>;
+    scene_path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scene_path: string;
+    root_type: string;
+    root_name?: string | undefined;
+}, {
+    scene_path: string;
+    root_type: string;
+    root_name?: string | undefined;
+}>>;
+export declare const sceneTools: AnyToolDefinition[];
+//# sourceMappingURL=scene.d.ts.map

package/dist/tools/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/tools/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,YAAY,2FAQvB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;GAYpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;GAepB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;GAoBtB,CAAC;AAEH,eAAO,MAAM,UAAU,EAKlB,iBAAiB,EAAE,CAAC"}

package/dist/tools/scene.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { defineTool } from '../core/define-tool.js';
+export const getSceneTree = defineTool({
+    name: 'get_scene_tree',
+    description: 'Get the full hierarchy of nodes in the currently open scene',
+    schema: z.object({}),
+    async execute(_, { godot }) {
+        const result = await godot.sendCommand('get_scene_tree');
+        return JSON.stringify(result.tree, null, 2);
+    },
+});
+export const openScene = defineTool({
+    name: 'open_scene',
+    description: 'Open a scene file in the editor',
+    schema: z.object({
+        scene_path: z
+            .string()
+            .describe('Path to the scene file (e.g., "res://scenes/main.tscn")'),
+    }),
+    async execute({ scene_path }, { godot }) {
+        await godot.sendCommand('open_scene', { scene_path });
+        return `Opened scene: ${scene_path}`;
+    },
+});
+export const saveScene = defineTool({
+    name: 'save_scene',
+    description: 'Save the currently open scene',
+    schema: z.object({
+        path: z
+            .string()
+            .optional()
+            .describe('Optional path to save as (defaults to current scene path)'),
+    }),
+    async execute({ path }, { godot }) {
+        const result = await godot.sendCommand('save_scene', {
+            path,
+        });
+        return `Saved scene: ${result.path}`;
+    },
+});
+export const createScene = defineTool({
+    name: 'create_scene',
+    description: 'Create a new scene with a root node',
+    schema: z.object({
+        root_type: z
+            .string()
+            .describe('Type of the root node (e.g., "Node2D", "Node3D", "Control")'),
+        root_name: z.string().optional().describe('Name of the root node'),
+        scene_path: z
+            .string()
+            .describe('Path to save the scene (e.g., "res://scenes/new_scene.tscn")'),
+    }),
+    async execute({ root_type, root_name, scene_path }, { godot }) {
+        await godot.sendCommand('create_scene', {
+            root_type,
+            root_name: root_name ?? root_type,
+            scene_path,
+        });
+        return `Created scene: ${scene_path} with root node type ${root_type}`;
+    },
+});
+export const sceneTools = [
+    getSceneTree,
+    openScene,
+    saveScene,
+    createScene,
+];
+//# sourceMappingURL=scene.js.map

package/dist/tools/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../src/tools/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,6DAA6D;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAoB,gBAAgB,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,iCAAiC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CAAC,yDAAyD,CAAC;KACvE,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE;QACrC,MAAM,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,OAAO,iBAAiB,UAAU,EAAE,CAAC;IACvC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,+BAA+B;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;KACzE,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAmB,YAAY,EAAE;YACrE,IAAI;SACL,CAAC,CAAC;QACH,OAAO,gBAAgB,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,qCAAqC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,CAAC,6DAA6D,CAAC;QAC1E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAClE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE;QAC3D,MAAM,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE;YACtC,SAAS;YACT,SAAS,EAAE,SAAS,IAAI,SAAS;YACjC,UAAU;SACX,CAAC,CAAC;QACH,OAAO,kBAAkB,UAAU,wBAAwB,SAAS,EAAE,CAAC;IACzE,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,YAAY;IACZ,SAAS;IACT,SAAS;IACT,WAAW;CACW,CAAC"}

package/dist/tools/script.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import type { AnyToolDefinition } from '../core/types.js';
+export declare const getScript: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    script_path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    script_path: string;
+}, {
+    script_path: string;
+}>>;
+export declare const createScript: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    script_path: z.ZodString;
+    content: z.ZodString;
+    attach_to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    script_path: string;
+    content: string;
+    attach_to?: string | undefined;
+}, {
+    script_path: string;
+    content: string;
+    attach_to?: string | undefined;
+}>>;
+export declare const editScript: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    script_path: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    script_path: string;
+    content: string;
+}, {
+    script_path: string;
+    content: string;
+}>>;
+export declare const attachScript: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    node_path: z.ZodString;
+    script_path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    node_path: string;
+    script_path: string;
+}, {
+    node_path: string;
+    script_path: string;
+}>>;
+export declare const detachScript: import("../core/types.js").ToolDefinition<z.ZodObject<{
+    node_path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    node_path: string;
+}, {
+    node_path: string;
+}>>;
+export declare const scriptTools: AnyToolDefinition[];
+//# sourceMappingURL=script.d.ts.map

package/dist/tools/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/tools/script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,SAAS;;;;;;GAcpB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;GAyBvB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;GAWrB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;GAWvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;GAUvB,CAAC;AAEH,eAAO,MAAM,WAAW,EAMnB,iBAAiB,EAAE,CAAC"}

package/dist/tools/script.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { defineTool } from '../core/define-tool.js';
+export const getScript = defineTool({
+    name: 'get_script',
+    description: 'Get the content of a GDScript file',
+    schema: z.object({
+        script_path: z
+            .string()
+            .describe('Path to the script file (e.g., "res://scripts/player.gd")'),
+    }),
+    async execute({ script_path }, { godot }) {
+        const result = await godot.sendCommand('read_script', {
+            script_path,
+        });
+        return `# ${script_path}\n\n\`\`\`gdscript\n${result.content}\n\`\`\``;
+    },
+});
+export const createScript = defineTool({
+    name: 'create_script',
+    description: 'Create a new GDScript file',
+    schema: z.object({
+        script_path: z
+            .string()
+            .describe('Path for the new script (e.g., "res://scripts/enemy.gd")'),
+        content: z.string().describe('Content of the script'),
+        attach_to: z
+            .string()
+            .optional()
+            .describe('Optional node path to attach the script to'),
+    }),
+    async execute({ script_path, content, attach_to }, { godot }) {
+        await godot.sendCommand('create_script', {
+            script_path,
+            content,
+            attach_to,
+        });
+        let message = `Created script: ${script_path}`;
+        if (attach_to) {
+            message += ` (attached to ${attach_to})`;
+        }
+        return message;
+    },
+});
+export const editScript = defineTool({
+    name: 'edit_script',
+    description: 'Replace the content of an existing GDScript file',
+    schema: z.object({
+        script_path: z.string().describe('Path to the script file'),
+        content: z.string().describe('New content for the script'),
+    }),
+    async execute({ script_path, content }, { godot }) {
+        await godot.sendCommand('edit_script', { script_path, content });
+        return `Updated script: ${script_path}`;
+    },
+});
+export const attachScript = defineTool({
+    name: 'attach_script',
+    description: 'Attach an existing script to a node',
+    schema: z.object({
+        node_path: z.string().describe('Path to the node'),
+        script_path: z.string().describe('Path to the script file'),
+    }),
+    async execute({ node_path, script_path }, { godot }) {
+        await godot.sendCommand('attach_script', { node_path, script_path });
+        return `Attached ${script_path} to ${node_path}`;
+    },
+});
+export const detachScript = defineTool({
+    name: 'detach_script',
+    description: 'Remove the script from a node',
+    schema: z.object({
+        node_path: z.string().describe('Path to the node'),
+    }),
+    async execute({ node_path }, { godot }) {
+        await godot.sendCommand('detach_script', { node_path });
+        return `Detached script from ${node_path}`;
+    },
+});
+export const scriptTools = [
+    getScript,
+    createScript,
+    editScript,
+    attachScript,
+    detachScript,
+];
+//# sourceMappingURL=script.js.map

package/dist/tools/script.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class GodotConnectionError extends Error {
+    constructor(message: string);
+}
+export declare class GodotCommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class GodotTimeoutError extends Error {
+    constructor(command: string, timeoutMs: number);
+}
+export interface ErrorResponse {
+    code: string;
+    message: string;
+}
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQlD"}

package/dist/utils/errors.js

@@ -0,0 +1,30 @@
+export class GodotConnectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GodotConnectionError';
+    }
+}
+export class GodotCommandError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'GodotCommandError';
+        this.code = code;
+    }
+}
+export class GodotTimeoutError extends Error {
+    constructor(command, timeoutMs) {
+        super(`Command '${command}' timed out after ${timeoutMs}ms`);
+        this.name = 'GodotTimeoutError';
+    }
+}
+export function formatError(error) {
+    if (error instanceof GodotCommandError) {
+        return `[${error.code}] ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1B,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,SAAiB;QAC5C,KAAK,CAAC,YAAY,OAAO,qBAAqB,SAAS,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAOD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@satelliteoflove/godot-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Godot Engine integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "godot-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/satelliteoflove/godot-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/satelliteoflove/godot-mcp/issues"
+  },
+  "homepage": "https://github.com/satelliteoflove/godot-mcp#readme",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "godot",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "game-development"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}