VICE C64 Emulator MCP Server

Instructions

Implementation Reference

• src/index.ts:173-198 (registration)

  Registration of the 'disconnect' MCP tool, including its inline handler function that calls ViceClient.disconnect() and formats the response.
  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/protocol/client.ts:144-156 (handler)

  The ViceClient.disconnect() method implementation, which closes the TCP socket connection to VICE and updates the connection state. This is called by the MCP tool handler.
  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:38-59 (helper)

  formatResponse helper function used by the disconnect tool handler to format the successful response with 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:62-91 (helper)

  formatError helper function used by the disconnect tool handler 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 ), }, ], }; }