AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/commit.ts:18-23 (handler)

  Handler logic for the 'list_commits' tool: parses input parameters using the schema, calls the listCommits function, and formats the response as JSON text.

  case 'list_commits':
    const listCommitsParams = ListCommitsRequestSchema.parse(request.params.arguments);
    const listCommitsResult = await listCommits(listCommitsParams);
    return {
      content: [{ type: "text", text: JSON.stringify(listCommitsResult, null, 2) }],
    };

• tool-registry/commit.ts:11-14 (registration)

  Registration of the 'list_commits' tool, including name, description, and input schema.

    name: 'list_commits',
    description: '[Code Management] List commits in a Codeup repository',
    inputSchema: zodToJsonSchema(ListCommitsRequestSchema),
  },

• operations/codeup/commits.ts:8-20 (schema)

  Zod schema definition for ListCommitsRequestSchema used for input validation.

  export const ListCommitsRequestSchema = z.object({
    organizationId: z.string().describe("组织ID"),
    repositoryId: z.string().describe("代码库ID或者URL-Encoder编码的全路径"),
    refName: z.string().describe("分支名称、标签名称或提交版本，默认为代码库默认分支"),
    since: z.string().optional().describe("提交起始时间，格式：YYYY-MM-DDTHH:MM:SSZ"),
    until: z.string().optional().describe("提交截止时间，格式：YYYY-MM-DDTHH:MM:SSZ"),
    page: z.number().int().optional().describe("页码"),
    perPage: z.number().int().optional().describe("每页大小"),
    path: z.string().optional().describe("文件路径"),
    search: z.string().optional().describe("搜索关键字"),
    showSignature: z.boolean().optional().describe("是否展示签名"),
    committerIds: z.string().optional().describe("提交人ID列表（多个ID以逗号隔开）"),
  });

• operations/codeup/commits.ts:62-128 (helper)

  Core implementation of listCommits: builds API URL with query params, makes GET request to Codeup API, parses and returns list of commits.

  export async function listCommits(params: z.infer<typeof ListCommitsRequestSchema>) {
    const {
      organizationId,
      repositoryId,
      refName,
      since,
      until,
      page,
      perPage,
      path,
      search,
      showSignature,
      committerIds
    } = params;
  
    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
    
    const baseUrl = `/oapi/v1/codeup/organizations/${organizationId}/repositories/${encodedRepoId}/commits`;
  
    const queryParams: Record<string, string | number | undefined> = {
      refName: refName
    };
    
    if (since !== undefined) {
      queryParams.since = since;
    }
    
    if (until !== undefined) {
      queryParams.until = until;
    }
    
    if (page !== undefined) {
      queryParams.page = page;
    }
    
    if (perPage !== undefined) {
      queryParams.perPage = perPage;
    }
    
    if (path !== undefined) {
      queryParams.path = path;
    }
    
    if (search !== undefined) {
      queryParams.search = search;
    }
    
    if (showSignature !== undefined) {
      queryParams.showSignature = String(showSignature);
    }
    
    if (committerIds !== undefined) {
      queryParams.committerIds = committerIds;
    }
  
    const url = buildUrl(baseUrl, queryParams);
  
    const response: any = await yunxiaoRequest(url, {
      method: "GET",
    });
  
    if (!Array.isArray(response)) {
      return [];
    }
  
    return response.map(commit => DevopsCommitVOSchemaType.parse(commit));
  }