BugBug MCP Server

Instructions

Implementation Reference

• src/tools/suites.ts:64-107 (handler)

  Full implementation of the 'get_suite' tool: defines the tool with name, input schema for suiteId, and handler that fetches the suite details using bugbugClient.getSuite and returns formatted MCP text content.

  export const getSuiteTool: Tool = {
    name: 'get_suite',
    title: 'Get details of a specific BugBug test suite',
    description: 'Get details of a specific BugBug test suite',
    inputSchema: z.object({
      suiteId: z.string().describe('Suite UUID'),
    }).shape,
    handler: async ({ suiteId }) => {
        try {
          const response = await bugbugClient.getSuite(suiteId);
          
          if (response.status !== 200) {
            return {
              content: [
                {
                  type: 'text',
                  text: `Error: ${response.status} ${response.statusText}`,
                },
              ],
            };
          }
  
          const suite = response.data;
          
          return {
            content: [
              {
                type: 'text',
                text: `**Suite Details:**\n\n- **Name:** ${suite.name || 'Unnamed Suite'}\n- **ID:** ${suite.id}\n- **Tests Count:** ${suite.testsCount || 0}`,
              },
            ],
          };
        } catch (error) {
          return {
            content: [
              {
                type: 'text',
                text: `Error fetching suite: ${error instanceof Error ? error.message : 'Unknown error'}`,
              },
            ],
          };
        }
      }
  };

• src/tools/suites.ts:68-70 (schema)

  Input schema for 'get_suite' tool using Zod: requires suiteId as string.

  inputSchema: z.object({
    suiteId: z.string().describe('Suite UUID'),
  }).shape,

• src/tools/index.ts:11-33 (registration)

  Registers all tools including 'get_suite' (from suitesTools import) with the MCP server by iterating over the tools record and calling server.registerTool with name, schema, and handler wrapper.

  export function registerAllTools(server: McpServer): void {
    const tools: Record<string, Tool> = {
      ...configTools,
      ...testsTools,
      ...testRunsTools,
      ...suitesTools,
      ...suiteRunsTools,
      ...profilesTools,
      ...advancedTools,
    };
  
    for (const t in tools) {
      server.registerTool(
        tools[t].name,
        {
          description: tools[t].description,
          inputSchema: tools[t].inputSchema,
          annotations: { title: tools[t].title },
        },
        (args: unknown) => tools[t].handler(args as unknown)
      );
    }
  }