AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/code-management.ts:239-259 (handler)

  The MCP tool handler switch case that parses the input arguments with CreateChangeRequestCommentSchema and invokes the createChangeRequestCommentFunc to execute the API call for creating a change request comment, returning the result as formatted JSON.
  case "create_change_request_comment": { const args = types.CreateChangeRequestCommentSchema.parse(request.params.arguments); const comment = await changeRequestComments.createChangeRequestCommentFunc( args.organizationId, args.repositoryId, args.localId, args.comment_type, args.content, args.draft, args.resolved, args.patchset_biz_id, args.file_path ?? undefined, args.line_number ?? undefined, args.from_patchset_biz_id ?? undefined, args.to_patchset_biz_id ?? undefined, args.parent_comment_biz_id ?? undefined ); return { content: [{ type: "text", text: JSON.stringify(comment, null, 2) }], }; }
• operations/codeup/types.ts:362-376 (schema)

  Zod schema defining the input validation for the create_change_request_comment tool parameters.
  export const CreateChangeRequestCommentSchema = z.object({ organizationId: z.string().describe("Organization ID, can be found in the basic information page of the organization admin console"), repositoryId: z.string().describe("Repository ID or a combination of organization ID and repository name, for example: 2835387 or organizationId%2Frepo-name (Note: slashes need to be URL encoded as %2F)"), localId: z.string().describe("Local ID, represents the nth merge request in the repository"), comment_type: z.string().default("GLOBAL_COMMENT").describe("Comment type. Possible values: GLOBAL_COMMENT, INLINE_COMMENT"), content: z.string().describe("Comment content, length must be between 1 and 65535"), draft: z.boolean().default(false).describe("Whether it is a draft comment"), resolved: z.boolean().default(false).describe("Whether to mark as resolved"), patchset_biz_id: z.string().describe("Associated version ID, if it's INLINE_COMMENT, choose one from from_patchset_biz_id or to_patchset_biz_id"), file_path: z.string().nullable().optional().describe("File name, only for inline comments"), line_number: z.number().int().nullable().optional().describe("Line number, only for inline comments"), from_patchset_biz_id: z.string().nullable().optional().describe("Start version ID for comparison, required for INLINE_COMMENT type"), to_patchset_biz_id: z.string().nullable().optional().describe("Target version ID for comparison, required for INLINE_COMMENT type"), parent_comment_biz_id: z.string().nullable().optional().describe("Parent comment ID"), });
• tool-registry/code-management.ts:95-98 (registration)

  Tool registration entry in the code-management tool registry, defining the tool name, description, and input schema.
  name: "create_change_request_comment", description: "[Code Management] Create a comment on a change request", inputSchema: zodToJsonSchema(types.CreateChangeRequestCommentSchema), },
• operations/codeup/changeRequestComments.ts:23-75 (helper)

  Supporting function that builds the API payload conditionally based on comment type (GLOBAL_COMMENT or INLINE_COMMENT), encodes repository ID, makes POST request to Codeup API to create the comment, and parses the response.
  export async function createChangeRequestCommentFunc( organizationId: string, repositoryId: string, localId: string, comment_type: string, // Possible values: GLOBAL_COMMENT, INLINE_COMMENT content: string, draft: boolean, resolved: boolean, patchset_biz_id: string, file_path?: string, line_number?: number, from_patchset_biz_id?: string, to_patchset_biz_id?: string, parent_comment_biz_id?: string ): Promise<z.infer<typeof ChangeRequestCommentSchema>> { const encodedRepoId = handleRepositoryIdEncoding(repositoryId); const url = `/oapi/v1/codeup/organizations/${organizationId}/repositories/${encodedRepoId}/changeRequests/${localId}/comments`; // 准备payload const payload: Record<string, any> = { comment_type: comment_type, content: content, draft: draft, resolved: resolved, patchset_biz_id: patchset_biz_id, }; // 根据评论类型添加必要参数 if (comment_type === "INLINE_COMMENT") { // 检查INLINE_COMMENT必需的参数 if (!file_path || line_number === undefined || !from_patchset_biz_id || !to_patchset_biz_id) { throw new Error("For INLINE_COMMENT, file_path, line_number, from_patchset_biz_id, and to_patchset_biz_id are required"); } payload.file_path = file_path; payload.line_number = line_number; payload.from_patchset_biz_id = from_patchset_biz_id; payload.to_patchset_biz_id = to_patchset_biz_id; } // 添加可选参数 if (parent_comment_biz_id) { payload.parent_comment_biz_id = parent_comment_biz_id; } const response = await yunxiaoRequest(url, { method: "POST", body: payload, }); return ChangeRequestCommentSchema.parse(response); }