Vite MCP Server

Instructions

Implementation Reference

• src/tools/hmr-tools.ts:16-50 (registration)

  Complete registration block for the 'get-hmr-events' tool, defining its name, description, input schema, and the handler function that returns recent HMR events.

  server.tool(
    'get-hmr-events',
    'Retrieves recent HMR events',
    {
      limit: z.number().optional().describe('Maximum number of events to return')
    },
    async ({ limit }) => {
      try {
        const eventsToReturn = limit ? lastHMREvents.slice(0, limit) : lastHMREvents;
  
        return {
          content: [
            {
              type: 'text',
              text: eventsToReturn.length > 0
                ? `Recent HMR events:\n${JSON.stringify(eventsToReturn, null, 2)}`
                : 'No HMR events detected yet.'
            }
          ]
        };
      } catch (error) {
        const errorMessage = error instanceof Error ? error.message : String(error);
        Logger.error(`Failed to get HMR events: ${errorMessage}`);
        return {
          content: [
            {
              type: 'text',
              text: `Failed to get HMR events: ${errorMessage}`
            }
          ],
          isError: true
        };
      }
    }
  );

• src/index.ts:85-85 (registration)

  Call to register HMR tools on the MCP server, providing the shared events array.

  registerHMRTools(server, lastHMREvents);

• src/index.ts:26-26 (helper)

  Shared mutable array storing recent HMR events, used by the tool handler.

  const lastHMREvents: HMREvent[] = [];

• src/types/hmr.ts:39-39 (schema)

  Type definition for HMR events, typing the events array used and returned by the tool.

  export type HMREvent = HMRUpdate | HMRError | HMRBrowserError | { type: string; [key: string]: unknown };

• src/tools/hmr-tools.ts:19-21 (schema)

  Zod input schema defining the optional 'limit' parameter for the number of events to retrieve.

  {
    limit: z.number().optional().describe('Maximum number of events to return')
  },