VICE C64 Emulator MCP Server

Instructions

Implementation Reference

• src/index.ts:674-699 (registration)

  MCP tool registration for toggleBreakpoint, including input schema and inline handler function that delegates to ViceClient.toggleCheckpoint and formats response
  "toggleBreakpoint", { description: `Enable or disable a breakpoint without deleting it. Use this to temporarily disable breakpoints while keeping their configuration. Related tools: setBreakpoint, deleteBreakpoint, listBreakpoints`, inputSchema: z.object({ breakpointId: z.number().describe("Breakpoint ID from setBreakpoint"), enabled: z.boolean().describe("True to enable, false to disable"), }), }, async (args) => { try { await client.toggleCheckpoint(args.breakpointId, args.enabled); return formatResponse({ success: true, breakpointId: args.breakpointId, enabled: args.enabled, message: `Breakpoint ${args.breakpointId} ${args.enabled ? "enabled" : "disabled"}`, }); } catch (error) { return formatError(error as ViceError); } } );
• src/protocol/client.ts:659-670 (handler)

  Core implementation of toggle checkpoint (breakpoint/watchpoint) in ViceClient: sends CheckpointToggle command to VICE binary monitor protocol and updates local tracking
  async toggleCheckpoint(checkpointId: number, enabled: boolean): Promise<void> { const body = Buffer.alloc(5); body.writeUInt32LE(checkpointId, 0); body[4] = enabled ? 1 : 0; await this.sendCommand(Command.CheckpointToggle, body); // Update local tracking const cp = this.checkpoints.get(checkpointId); if (cp) { cp.enabled = enabled; } }
• src/index.ts:681-684 (schema)

  Zod input schema validation for toggleBreakpoint tool parameters: breakpointId (number) and enabled (boolean)
  inputSchema: z.object({ breakpointId: z.number().describe("Breakpoint ID from setBreakpoint"), enabled: z.boolean().describe("True to enable, false to disable"), }),