VICE C64 Emulator MCP Server

Instructions

Implementation Reference

• src/index.ts:546-558 (handler)

  Handler function that executes the reset tool logic: calls underlying client.reset() with hard flag from args, formats MCP response with state metadata or error
  async (args) => { try { await client.reset(args.hard || false); return formatResponse({ reset: true, type: args.hard ? "hard" : "soft", message: `${args.hard ? "Hard" : "Soft"} reset performed`, hint: "C64 is now at startup. Use status() to check state.", }); } catch (error) { return formatError(error as ViceError); } }
• src/index.ts:542-544 (schema)

  Zod input schema defining optional 'hard' boolean parameter for hard/soft reset
  inputSchema: z.object({ hard: z.boolean().optional().describe("Hard reset (true) vs soft reset (false, default)"), }),
• src/index.ts:531-559 (registration)

  Registration of the 'reset' MCP tool on the McpServer instance
  server.registerTool( "reset", { description: `Reset the C64 machine. Options: - hard: If true, performs hard reset (like power cycle). If false, soft reset (like reset button). A soft reset preserves some memory contents, hard reset clears everything. Related tools: connect, status`, inputSchema: z.object({ hard: z.boolean().optional().describe("Hard reset (true) vs soft reset (false, default)"), }), }, async (args) => { try { await client.reset(args.hard || false); return formatResponse({ reset: true, type: args.hard ? "hard" : "soft", message: `${args.hard ? "Hard" : "Soft"} reset performed`, hint: "C64 is now at startup. Use status() to check state.", }); } catch (error) { return formatError(error as ViceError); } } );
• src/protocol/client.ts:537-541 (helper)

  Low-level ViceClient.reset method: constructs 1-byte body (1 for hard reset, 0 for soft) and sends to VICE via sendCommand(Command.Reset)
  async reset(hard = false): Promise<void> { const body = Buffer.alloc(1); body[0] = hard ? 1 : 0; await this.sendCommand(Command.Reset, body); }
• src/protocol/types.ts:59-59 (helper)

  Protocol constant defining Command.Reset as 0xcc (VICE binary monitor command code)
  Reset = 0xcc,