@keeveeg/godot-mcp 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Godot MCP Server Configuration
+ */
+/** Base port for WebSocket connections */
+export declare const WS_BASE_PORT = 6505;
+/** Maximum number of concurrent AI sessions (ports 6505-6514) */
+export declare const MAX_SESSIONS = 10;
+/** Request timeout in milliseconds */
+export declare const REQUEST_TIMEOUT_MS = 30000;
+/** Ping interval for WebSocket keepalive in milliseconds */
+export declare const PING_INTERVAL_MS = 30000;
+/** Ping timeout - disconnect if no pong received within this time */
+export declare const PING_TIMEOUT_MS = 15000;
+/** Maximum message size in bytes (10MB) */
+export declare const MAX_MESSAGE_SIZE: number;
+/** Server version */
+export declare const SERVER_VERSION = "1.0.0";
+/** Server name for MCP identification */
+export declare const SERVER_NAME = "godot-mcp";
+/** JSON-RPC version used for communication */
+export declare const JSONRPC_VERSION: "2.0";
+/** Reconnect delay in milliseconds */
+export declare const RECONNECT_DELAY_MS = 1000;
+/** Maximum reconnection attempts */
+export declare const MAX_RECONNECT_ATTEMPTS = 5;
+/** Log level configuration */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Current log level */
+export declare const LOG_LEVEL: LogLevel;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,iEAAiE;AACjE,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,qEAAqE;AACrE,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD,qBAAqB;AACrB,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,yCAAyC;AACzC,eAAO,MAAM,WAAW,cAAc,CAAC;AAEvC,8CAA8C;AAC9C,eAAO,MAAM,eAAe,EAAG,KAAc,CAAC;AAE9C,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC,oCAAoC;AACpC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,8BAA8B;AAC9B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,wBAAwB;AACxB,eAAO,MAAM,SAAS,EAAE,QAAiB,CAAC"}

package/dist/config.js

@@ -0,0 +1,28 @@
+/**
+ * Godot MCP Server Configuration
+ */
+/** Base port for WebSocket connections */
+export const WS_BASE_PORT = 6505;
+/** Maximum number of concurrent AI sessions (ports 6505-6514) */
+export const MAX_SESSIONS = 10;
+/** Request timeout in milliseconds */
+export const REQUEST_TIMEOUT_MS = 30_000;
+/** Ping interval for WebSocket keepalive in milliseconds */
+export const PING_INTERVAL_MS = 30_000;
+/** Ping timeout - disconnect if no pong received within this time */
+export const PING_TIMEOUT_MS = 15_000;
+/** Maximum message size in bytes (10MB) */
+export const MAX_MESSAGE_SIZE = 10 * 1024 * 1024;
+/** Server version */
+export const SERVER_VERSION = '1.0.0';
+/** Server name for MCP identification */
+export const SERVER_NAME = 'godot-mcp';
+/** JSON-RPC version used for communication */
+export const JSONRPC_VERSION = '2.0';
+/** Reconnect delay in milliseconds */
+export const RECONNECT_DELAY_MS = 1_000;
+/** Maximum reconnection attempts */
+export const MAX_RECONNECT_ATTEMPTS = 5;
+/** Current log level */
+export const LOG_LEVEL = 'info';
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,sCAAsC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,qBAAqB;AACrB,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,KAAc,CAAC;AAE9C,sCAAsC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,oCAAoC;AACpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAKxC,wBAAwB;AACxB,MAAM,CAAC,MAAM,SAAS,GAAa,MAAM,CAAC"}

package/dist/godot-bridge.d.ts

@@ -0,0 +1,81 @@
+/**
+ * WebSocket bridge for communicating with Godot EditorPlugin
+ *
+ * Godot connects as a WebSocket CLIENT to this server.
+ * Uses JSON-RPC 2.0 for message format.
+ */
+import type { ConnectionState } from './types.js';
+/**
+ * WebSocket bridge that manages communication with Godot EditorPlugin.
+ *
+ * The bridge starts a WebSocket server that Godot connects to.
+ * Each tool request is forwarded as a JSON-RPC 2.0 call.
+ */
+export declare class GodotBridge {
+    private wss;
+    private client;
+    private port;
+    private state;
+    private pendingRequests;
+    private pingInterval;
+    private lastPongTime;
+    private requestIdCounter;
+    constructor(port?: number);
+    /**
+     * Start the WebSocket server, trying ports 6505-6514 if busy.
+     */
+    start(): Promise<number>;
+    /**
+     * Try to listen on a specific port.
+     */
+    private tryListen;
+    /**
+     * Set up the WebSocket server event handlers.
+     */
+    private setupServer;
+    /**
+     * Set up event handlers for a connected client.
+     */
+    private setupClientHandlers;
+    /**
+     * Start the ping/pong keepalive interval.
+     */
+    private startPingInterval;
+    /**
+     * Stop the ping interval.
+     */
+    private stopPingInterval;
+    /**
+     * Handle an incoming WebSocket message.
+     */
+    private handleMessage;
+    /**
+     * Send a JSON-RPC 2.0 request to Godot and wait for a response.
+     */
+    sendRequest(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Send a JSON-RPC 2.0 notification (no response expected).
+     */
+    sendNotification(method: string, params?: Record<string, unknown>): void;
+    /**
+     * Clean up connection state.
+     */
+    private cleanup;
+    /**
+     * Get the current connection state.
+     */
+    getState(): ConnectionState;
+    /**
+     * Check if a Godot client is connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Get the port the server is listening on.
+     */
+    getPort(): number;
+    /**
+     * Shut down the bridge and close all connections.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=godot-bridge.d.ts.map

package/dist/godot-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"godot-bridge.d.ts","sourceRoot":"","sources":["../src/godot-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAMV,eAAe,EAChB,MAAM,YAAY,CAAC;AA6BpB;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,IAAI,GAAE,MAAqB;IAIvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAe9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAyBjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyCzF;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAe5E;;OAEG;IACH,OAAO,CAAC,OAAO;IAaf;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAahC"}

package/dist/godot-bridge.js

@@ -0,0 +1,294 @@
+/**
+ * WebSocket bridge for communicating with Godot EditorPlugin
+ *
+ * Godot connects as a WebSocket CLIENT to this server.
+ * Uses JSON-RPC 2.0 for message format.
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+import { randomUUID } from 'node:crypto';
+import { WS_BASE_PORT, MAX_SESSIONS, REQUEST_TIMEOUT_MS, PING_INTERVAL_MS, PING_TIMEOUT_MS, MAX_MESSAGE_SIZE, JSONRPC_VERSION } from './config.js';
+import { isSuccessResponse, isErrorResponse } from './types.js';
+/** Logger helper */
+function log(level, message, ...args) {
+  const timestamp = new Date().toISOString();
+  const prefix = `[GodotBridge ${timestamp}]`;
+  switch (level) {
+    case 'error':
+      console.error(prefix, message, ...args);
+      break;
+    case 'warn':
+      console.warn(prefix, message, ...args);
+      break;
+    case 'debug':
+      // Only log debug in development
+      if (process.env.GODOT_MCP_DEBUG) {
+        console.error(prefix, message, ...args);
+      }
+      break;
+    default:
+      console.error(prefix, message, ...args);
+  }
+}
+/**
+ * WebSocket bridge that manages communication with Godot EditorPlugin.
+ *
+ * The bridge starts a WebSocket server that Godot connects to.
+ * Each tool request is forwarded as a JSON-RPC 2.0 call.
+ */
+export class GodotBridge {
+  wss = null;
+  client = null;
+  port;
+  state = 'disconnected';
+  pendingRequests = new Map();
+  pingInterval = null;
+  lastPongTime = 0;
+  requestIdCounter = 0;
+  constructor(port = WS_BASE_PORT) {
+    this.port = port;
+  }
+  /**
+   * Start the WebSocket server, trying ports 6505-6514 if busy.
+   */
+  async start() {
+    for (let portOffset = 0; portOffset < MAX_SESSIONS; portOffset++) {
+      const tryPort = this.port + portOffset;
+      const success = await this.tryListen(tryPort);
+      if (success) {
+        this.port = tryPort;
+        log('info', `Listening on port ${tryPort}`);
+        return tryPort;
+      }
+    }
+    throw new Error(`Failed to bind to any port in range ${WS_BASE_PORT}-${WS_BASE_PORT + MAX_SESSIONS - 1}`);
+  }
+  /**
+   * Try to listen on a specific port.
+   */
+  tryListen(port) {
+    return new Promise((resolve) => {
+      const wss = new WebSocketServer({
+        port,
+        maxPayload: MAX_MESSAGE_SIZE,
+      });
+      wss.on('listening', () => {
+        this.wss = wss;
+        this.setupServer(wss);
+        resolve(true);
+      });
+      wss.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+          log('debug', `Port ${port} is busy`);
+          resolve(false);
+        } else {
+          log('error', `Server error on port ${port}:`, err.message);
+          resolve(false);
+        }
+      });
+    });
+  }
+  /**
+   * Set up the WebSocket server event handlers.
+   */
+  setupServer(wss) {
+    wss.on('connection', (ws) => {
+      // Only allow one client at a time
+      if (this.client && this.client.readyState === WebSocket.OPEN) {
+        log('warn', 'Rejecting new client - one client already connected');
+        ws.close(1013, 'Another client is already connected');
+        return;
+      }
+      this.client = ws;
+      this.state = 'connected';
+      this.lastPongTime = Date.now();
+      log('info', 'Godot editor connected');
+      this.setupClientHandlers(ws);
+      this.startPingInterval(ws);
+    });
+    wss.on('error', (err) => {
+      log('error', 'WebSocket server error:', err.message);
+    });
+  }
+  /**
+   * Set up event handlers for a connected client.
+   */
+  setupClientHandlers(ws) {
+    ws.on('message', (data) => {
+      this.handleMessage(data);
+    });
+    ws.on('close', (code, reason) => {
+      log('info', `Godot editor disconnected (code: ${code}, reason: ${reason.toString()})`);
+      this.cleanup();
+    });
+    ws.on('error', (err) => {
+      log('error', 'Client WebSocket error:', err.message);
+    });
+    ws.on('pong', () => {
+      this.lastPongTime = Date.now();
+    });
+  }
+  /**
+   * Start the ping/pong keepalive interval.
+   */
+  startPingInterval(ws) {
+    this.stopPingInterval();
+    this.pingInterval = setInterval(() => {
+      if (ws.readyState !== WebSocket.OPEN) {
+        this.stopPingInterval();
+        return;
+      }
+      // Check if last pong was too long ago
+      const timeSinceLastPong = Date.now() - this.lastPongTime;
+      if (timeSinceLastPong > PING_INTERVAL_MS + PING_TIMEOUT_MS) {
+        log('warn', 'No pong received, closing connection');
+        ws.terminate();
+        return;
+      }
+      ws.ping();
+    }, PING_INTERVAL_MS);
+  }
+  /**
+   * Stop the ping interval.
+   */
+  stopPingInterval() {
+    if (this.pingInterval) {
+      clearInterval(this.pingInterval);
+      this.pingInterval = null;
+    }
+  }
+  /**
+   * Handle an incoming WebSocket message.
+   */
+  handleMessage(data) {
+    let message;
+    try {
+      message = JSON.parse(data.toString());
+    } catch {
+      log('error', 'Failed to parse message as JSON');
+      return;
+    }
+    // Check if this is a response to a pending request
+    if ('id' in message && message.id !== undefined && message.id !== null) {
+      const pending = this.pendingRequests.get(message.id);
+      if (pending) {
+        this.pendingRequests.delete(message.id);
+        clearTimeout(pending.timer);
+        const response = message;
+        if (isSuccessResponse(response)) {
+          log('debug', `Response for ${pending.method}: success`);
+          pending.resolve(response.result);
+        } else if (isErrorResponse(response)) {
+          const err = response;
+          const error = new Error(err.error.message);
+          error.code = err.error.code;
+          error.data = err.error.data;
+          log('debug', `Response for ${pending.method}: error - ${err.error.message}`);
+          pending.reject(error);
+        }
+        return;
+      }
+    }
+    // Otherwise it might be a notification from Godot (e.g., scene_changed)
+    log('debug', 'Received notification:', message);
+  }
+  /**
+   * Send a JSON-RPC 2.0 request to Godot and wait for a response.
+   */
+  async sendRequest(method, params = {}) {
+    if (!this.client || this.client.readyState !== WebSocket.OPEN) {
+      throw new Error('Godot editor is not connected');
+    }
+    const id = `mcp_${++this.requestIdCounter}_${randomUUID().slice(0, 8)}`;
+    const request = {
+      jsonrpc: JSONRPC_VERSION,
+      id,
+      method,
+      params,
+    };
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pendingRequests.delete(id);
+        reject(new Error(`Request ${method} timed out after ${REQUEST_TIMEOUT_MS}ms`));
+      }, REQUEST_TIMEOUT_MS);
+      this.pendingRequests.set(id, {
+        id,
+        method,
+        resolve,
+        reject,
+        timer,
+      });
+      const message = JSON.stringify(request);
+      log('debug', `Sending request: ${method} (id: ${id})`);
+      this.client.send(message, (err) => {
+        if (err) {
+          this.pendingRequests.delete(id);
+          clearTimeout(timer);
+          reject(new Error(`Failed to send request: ${err.message}`));
+        }
+      });
+    });
+  }
+  /**
+   * Send a JSON-RPC 2.0 notification (no response expected).
+   */
+  sendNotification(method, params = {}) {
+    if (!this.client || this.client.readyState !== WebSocket.OPEN) {
+      log('warn', `Cannot send notification ${method}: Godot not connected`);
+      return;
+    }
+    const notification = {
+      jsonrpc: JSONRPC_VERSION,
+      method,
+      params,
+    };
+    this.client.send(JSON.stringify(notification));
+  }
+  /**
+   * Clean up connection state.
+   */
+  cleanup() {
+    this.state = 'disconnected';
+    this.client = null;
+    this.stopPingInterval();
+    // Reject all pending requests
+    for (const [, pending] of this.pendingRequests) {
+      clearTimeout(pending.timer);
+      pending.reject(new Error('Connection closed'));
+    }
+    this.pendingRequests.clear();
+  }
+  /**
+   * Get the current connection state.
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Check if a Godot client is connected.
+   */
+  isConnected() {
+    return this.client !== null && this.client.readyState === WebSocket.OPEN;
+  }
+  /**
+   * Get the port the server is listening on.
+   */
+  getPort() {
+    return this.port;
+  }
+  /**
+   * Shut down the bridge and close all connections.
+   */
+  async shutdown() {
+    log('info', 'Shutting down bridge...');
+    this.cleanup();
+    if (this.wss) {
+      await new Promise((resolve) => {
+        this.wss.close(() => {
+          this.wss = null;
+          resolve();
+        });
+      });
+    }
+  }
+}
+//# sourceMappingURL=godot-bridge.js.map

package/dist/godot-bridge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Godot MCP Server Entry Point
+ *
+ * Creates the MCP server with stdio transport and WebSocket bridge
+ * for communicating with Godot EditorPlugin.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * Godot MCP Server Entry Point
+ *
+ * Creates the MCP server with stdio transport and WebSocket bridge
+ * for communicating with Godot EditorPlugin.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { GodotBridge } from './godot-bridge.js';
+import { createServer } from './server.js';
+import { registerAllTools } from './tools/index.js';
+import { SERVER_NAME, SERVER_VERSION } from './config.js';
+async function main() {
+  // Log to stderr (stdout is reserved for MCP protocol)
+  console.error(`[${SERVER_NAME}] Starting v${SERVER_VERSION}...`);
+  // Create the Godot bridge (WebSocket server)
+  const bridge = new GodotBridge();
+  const port = await bridge.start();
+  console.error(`[${SERVER_NAME}] WebSocket bridge listening on port ${port}`);
+  // Create the MCP server
+  const server = createServer(bridge);
+  // Register all tools
+  registerAllTools(server, bridge);
+  console.error(`[${SERVER_NAME}] Tools registered`);
+  // Connect stdio transport
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`[${SERVER_NAME}] MCP server connected via stdio`);
+  // Graceful shutdown
+  const shutdown = async (signal) => {
+    console.error(`\n[${SERVER_NAME}] Received ${signal}, shutting down...`);
+    try {
+      await server.close();
+      await bridge.shutdown();
+      console.error(`[${SERVER_NAME}] Shutdown complete`);
+      process.exit(0);
+    } catch (err) {
+      console.error(`[${SERVER_NAME}] Error during shutdown:`, err);
+      process.exit(1);
+    }
+  };
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+  // Handle stdin close (MCP client disconnected)
+  process.stdin.on('close', () => {
+    console.error(`[${SERVER_NAME}] stdin closed, shutting down...`);
+    void shutdown('stdin-close');
+  });
+  // Handle uncaught errors
+  process.on('uncaughtException', (err) => {
+    console.error(`[${SERVER_NAME}] Uncaught exception:`, err);
+  });
+  process.on('unhandledRejection', (reason) => {
+    console.error(`[${SERVER_NAME}] Unhandled rejection:`, reason);
+  });
+}
+main().catch((err) => {
+  console.error(`[${SERVER_NAME}] Fatal error:`, err);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+/**
+ * McpServer factory with tool registration
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { GodotBridge } from './godot-bridge.js';
+import type { ToolResult } from './types.js';
+/**
+ * Type for a tool handler function.
+ * Receives parsed params and the bridge, returns a ToolResult.
+ */
+export type ToolHandler = (params: Record<string, unknown>, bridge: GodotBridge) => Promise<ToolResult>;
+/**
+ * Create and configure the MCP server instance.
+ */
+export declare function createServer(_bridge: GodotBridge): McpServer;
+/**
+ * Register a tool with the MCP server.
+ * This wraps the handler to always receive the bridge instance.
+ */
+export declare function registerTool(server: McpServer, bridge: GodotBridge, name: string, description: string, schema: Record<string, import('zod').ZodType>, handler: ToolHandler): void;
+/**
+ * Helper to call Godot via the bridge and format the result.
+ */
+export declare function callGodot(bridge: GodotBridge, method: string, params?: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAO5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,OAAO,CAAC,EAC7C,OAAO,EAAE,WAAW,GACnB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,UAAU,CAAC,CASrB"}

package/dist/server.js

@@ -0,0 +1,45 @@
+/**
+ * McpServer factory with tool registration
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SERVER_NAME, SERVER_VERSION } from './config.js';
+import { createErrorResult } from './types.js';
+/**
+ * Create and configure the MCP server instance.
+ */
+export function createServer(_bridge) {
+  const server = new McpServer({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+  });
+  return server;
+}
+/**
+ * Register a tool with the MCP server.
+ * This wraps the handler to always receive the bridge instance.
+ */
+export function registerTool(server, bridge, name, description, schema, handler) {
+  server.tool(name, description, schema, async (args) => {
+    try {
+      const result = await handler(args, bridge);
+      return result;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return createErrorResult(`Tool ${name} failed: ${message}`);
+    }
+  });
+}
+/**
+ * Helper to call Godot via the bridge and format the result.
+ */
+export async function callGodot(bridge, method, params = {}) {
+  try {
+    const result = await bridge.sendRequest(method, params);
+    const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+    return { content: [{ type: 'text', text }] };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return createErrorResult(`Godot request failed: ${message}`);
+  }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAW/C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,MAAmB,EACnB,IAAY,EACZ,WAAmB,EACnB,MAA6C,EAC7C,OAAoB;IAEpB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,iBAAiB,CAAC,QAAQ,IAAI,YAAY,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAmB,EACnB,MAAc,EACd,SAAkC,EAAE;IAEpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,iBAAiB,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/tools/accessibility.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Accessibility tools - 6 tools for accessibility auditing and compliance
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GodotBridge } from "../godot-bridge.js";
+export declare function registerAccessibilityTools(server: McpServer, bridge: GodotBridge): void;
+//# sourceMappingURL=accessibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/tools/accessibility.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAqEvF"}