Xray MCP Server

Instructions

Implementation Reference

• src/index.ts:446-464 (registration)

  Registration of the 'get_project_test_sets' tool in the tools array, including name, description, and input schema used for listing tools.

  {
    name: 'get_project_test_sets',
    description: 'Get all test sets for a specific project',
    inputSchema: {
      type: 'object',
      properties: {
        projectKey: {
          type: 'string',
          description: 'The Jira project key (e.g., "PROJ")',
        },
        maxResults: {
          type: 'number',
          description: 'Maximum number of results to return',
          default: 50,
        },
      },
      required: ['projectKey'],
    },
  },

• src/index.ts:841-854 (handler)

  MCP tool execution handler: extracts projectKey and optional maxResults from arguments, calls xrayClient.getTestSetsByProject, serializes result as JSON text response.

  case 'get_project_test_sets': {
    const result = await xrayClient.getTestSetsByProject(
      args.projectKey as string,
      args.maxResults as number | undefined
    );
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/xray-client.ts:907-910 (helper)

  XrayClient helper method: constructs JQL query for project test sets and delegates to searchTestSets GraphQL method.

  async getTestSetsByProject(projectKey: string, maxResults: number = 50): Promise<any> {
    const jql = `project = '${projectKey}'`;
    return this.searchTestSets(jql, maxResults);
  }