Zebrunner MCP Server

Instructions

Implementation Reference

• src/index.ts:129-148 (registration)

  MCP tool registration for 'list_test_suites', including inline input schema validation and execution handler that fetches suites via ZebrunnerClient and returns JSON.

  server.tool(
    "list_test_suites",
    "Return list of Zebrunner test suites for a project (requires project_key or project_id)",
    {
      project_key: z.string().optional(),
      project_id: z.number().int().positive().optional()
    },
    async (args) => {
      const { project_key, project_id } = args;
      if (!project_key && !project_id) {
        throw new Error("Either project_key or project_id must be provided");
      }
      const suites = await client.listTestSuites({ projectKey: project_key, projectId: project_id });
      const data = suites.map((s: unknown) => {
        const parsed = TestSuiteSchema.safeParse(s);
        return parsed.success ? parsed.data : s;
      });
      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
    }
  );

• src/types.ts:8-13 (schema)

  Zod input schema definition for listTestSuites tool parameters (imported but uses inline equivalent in handler).

  export const ListTestSuitesSchema = z.object({
    project_key: z.string().optional(),
    project_id: z.number().int().positive().optional()
  }).refine(data => data.project_key || data.project_id, {
    message: "Either project_key or project_id must be provided"
  });

• src/zebrunnerClient.ts:48-55 (helper)

  Core API client method implementing the test suites list fetch from Zebrunner API, called by the MCP tool handler.

  async listTestSuites(params: TestSuiteParams): Promise<any[]> {
    const { projectKey, projectId } = params;
    const res = await this.http.get("/test-suites", {
      params: { projectKey, projectId }
    });
    // API returns {items: [], _meta: {}} structure
    return Array.isArray(res.data) ? res.data : (res.data?.items || []);
  }