Zebrunner MCP Server

Instructions

Implementation Reference

• src/handlers/tools.ts:314-337 (handler)

  The primary handler method in ZebrunnerToolHandlers class that implements the get_root_suites tool logic: fetches root suites from API client, enriches with hierarchy information, formats the output, and returns MCP-compatible content response.

  async getRootSuites(projectKey: string, format: OutputFormat = 'json') {
    try {
      const rootSuites = await this.client.getRootSuites(projectKey);
      const enrichedSuites = HierarchyProcessor.enrichSuitesWithHierarchy(rootSuites);
      const formattedData = FormatProcessor.format(enrichedSuites, format);
      
      return {
        content: [
          {
            type: "text" as const,
            text: typeof formattedData === 'string' ? formattedData : JSON.stringify(formattedData, null, 2)
          }
        ]
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text" as const,
            text: `Error retrieving root suites: ${error.message}`
          }
        ]
      };
    }

• src/index-enhanced.ts:145-153 (registration)

  MCP server tool registration for 'get_root_suites', including inline Zod input schema validation and handler invocation.

  server.tool(
    "get_root_suites",
    "Get only root-level test suites with hierarchy information",
    {
      projectKey: z.string().min(1),
      format: z.enum(['dto', 'json', 'string']).default('json')
    },
    async (args) => toolHandlers.getRootSuites(args.projectKey, args.format)
  );

• src/index-enhanced.ts:149-151 (schema)

  Inline Zod schema defining input parameters for get_root_suites tool: projectKey (required string) and format (optional enum).

    projectKey: z.string().min(1),
    format: z.enum(['dto', 'json', 'string']).default('json')
  },

• src/api/client.ts:438-441 (helper)

  API client helper method that retrieves all test suites and filters to root-level ones (no parentSuiteId), called by the main handler.

  async getRootSuites(projectKey: string): Promise<ZebrunnerTestSuite[]> {
    const allSuites = await this.getAllTestSuites(projectKey);
    return allSuites.filter(suite => !suite.parentSuiteId);
  }