QIT MCP Server

Instructions

Implementation Reference

• src/tools/groups.ts:15-20 (handler)

  The handler function implementing the core logic of the 'get_group_status' tool. It builds CLI arguments for the 'group:fetch' command using buildArgs and executes it via executeAndFormat, returning the formatted result.

  handler: async (args: { group: string; json?: boolean }) => {
    const cmdArgs = buildArgs("group:fetch", [args.group], {
      json: args.json,
    });
    return executeAndFormat(cmdArgs);
  },

• src/tools/groups.ts:8-14 (schema)

  Zod schema for input validation: requires 'group' string, optional 'json' boolean.

  inputSchema: z.object({
    group: z.string().describe("Name of the test group to fetch status for"),
    json: z
      .boolean()
      .optional()
      .describe("Return output in JSON format"),
  }),

• src/tools/groups.ts:4-22 (registration)

  Tool definition and registration object 'groupsTools' exporting the 'get_group_status' tool with name, description, inputSchema, and handler.

  export const groupsTools = {
    get_group_status: {
      name: "get_group_status",
      description: "Fetch the status of a registered test group from QIT Manager.",
      inputSchema: z.object({
        group: z.string().describe("Name of the test group to fetch status for"),
        json: z
          .boolean()
          .optional()
          .describe("Return output in JSON format"),
      }),
      handler: async (args: { group: string; json?: boolean }) => {
        const cmdArgs = buildArgs("group:fetch", [args.group], {
          json: args.json,
        });
        return executeAndFormat(cmdArgs);
      },
    },
  };

• src/tools/index.ts:10-18 (registration)

  Central registration aggregating all tool sets, including groupsTools containing 'get_group_status', into 'allTools'.

  export const allTools = {
    ...authTools,
    ...testExecutionTools,
    ...testResultsTools,
    ...groupsTools,
    ...environmentTools,
    ...packagesTools,
    ...configTools,
    ...utilitiesTools,

• src/server.ts:25-38 (registration)

  MCP server request handler for listing tools, dynamically generating the tools list from allTools including schemas and descriptions for 'get_group_status'.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    // Check if QIT CLI is available
    const cliInfo = detectQitCli();
  
    const tools = Object.entries(allTools).map(([_, tool]) => ({
      name: tool.name,
      description: cliInfo
        ? tool.description
        : `${tool.description}\n\n⚠️ QIT CLI not detected. ${getQitCliNotFoundError()}`,
      inputSchema: zodToJsonSchema(tool.inputSchema),
    }));
  
    return { tools };
  });