VICE C64 Emulator MCP Server

Instructions

Implementation Reference

• src/index.ts:161-186 (registration)

  Registers the MCP 'disconnect' tool with no input schema and inline handler function.
  server.registerTool( "disconnect", { description: `Disconnect from the VICE emulator instance. Cleanly closes the connection. Safe to call even if not connected. Related tools: connect, status`, }, async () => { const wasConnected = client.getState().connected; try { await client.disconnect(); return formatResponse({ disconnected: true, wasConnected, message: wasConnected ? "Disconnected from VICE" : "Was not connected", }); } catch (error) { return formatError(error as ViceError); } } );
• src/index.ts:170-185 (handler)

  The main handler function for the 'disconnect' MCP tool. Checks connection state, calls underlying ViceClient.disconnect(), and returns formatted response.
  async () => { const wasConnected = client.getState().connected; try { await client.disconnect(); return formatResponse({ disconnected: true, wasConnected, message: wasConnected ? "Disconnected from VICE" : "Was not connected", }); } catch (error) { return formatError(error as ViceError); } }
• src/protocol/client.ts:144-156 (handler)

  Underlying ViceClient.disconnect() method implementation that closes the TCP socket connection to VICE emulator.
  async disconnect(): Promise<void> { if (!this.socket) { return; } return new Promise((resolve) => { this.socket!.once("close", () => { this.state.connected = false; resolve(); }); this.socket!.end(); }); }
• src/index.ts:26-47 (helper)

  Helper function used by all MCP tools to format responses with JSON data and connection metadata.
  function formatResponse(data: object) { const state = client.getState(); return { content: [ { type: "text" as const, text: JSON.stringify( { ...data, _meta: { connected: state.connected, running: state.running, ...(state.connected && { host: state.host, port: state.port }), }, }, null, 2 ), }, ], }; }
• src/index.ts:50-79 (helper)

  Helper function used by MCP tools to format error responses with connection metadata.
  function formatError(error: ViceError | Error) { const state = client.getState(); const errorData = "code" in error ? error : { error: true, code: "UNKNOWN_ERROR", message: error.message, }; return { content: [ { type: "text" as const, text: JSON.stringify( { ...errorData, _meta: { connected: state.connected, running: state.running, }, }, null, 2 ), }, ], }; }