AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/effort.ts:73-89 (handler)

  MCP tool handler for 'update_effort_record': parses input arguments using UpdateEffortRecordSchema and calls the underlying effort.updateEffortRecord function.

  case "update_effort_record": {
    const args = types.UpdateEffortRecordSchema.parse(request.params.arguments);
    await effort.updateEffortRecord({
      organizationId: args.organizationId,
      workitemId: args.workitemId,
      id: args.id,
      actualTime: args.actualTime,
      description: args.description,
      gmtEnd: args.gmtEnd,
      gmtStart: args.gmtStart,
      operatorId: args.operatorId,
      workType: args.workType
    });
    return {
      content: [{ type: "text", text: "Effort record updated successfully" }],
    };
  }

• operations/projex/effort.ts:117-141 (helper)

  Core implementation of updateEffortRecord: validates parameters, constructs API URL, and performs PUT request to update the effort record via yunxiaoRequest.

  export async function updateEffortRecord(
    params: z.infer<typeof CreateEffortRecordRequestSchema> & {
      organizationId: string;
      workitemId: string;
      id: string;
    }
  ) {
    const validatedParams = CreateEffortRecordRequestSchema.parse({
      actualTime: params.actualTime,
      description: params.description,
      gmtEnd: params.gmtEnd,
      gmtStart: params.gmtStart,
      operatorId: params.operatorId,
      workType: params.workType
    });
    
    const url = `/oapi/v1/projex/organizations/${params.organizationId}/workitems/${params.workitemId}/effortRecords/${params.id}`;
    
    const response = await yunxiaoRequest(url, {
      method: "PUT",
      body: validatedParams
    });
  
    return response;
  }

• tool-registry/effort.ts:38-42 (registration)

  Tool registration defining the name, description, and input schema (derived from UpdateEffortRecordSchema) for 'update_effort_record'.

  {
    name: "update_effort_record",
    description: "[Project Management] 更新登记实际工时",
    inputSchema: zodToJsonSchema(UpdateEffortRecordSchema),
  },

• operations/projex/types.ts:548-558 (schema)

  Zod schema definition for UpdateEffortRecord input validation, including fields like organizationId, workitemId, id, actualTime, etc.

  export const UpdateEffortRecordSchema = z.object({
    organizationId: z.string().describe("organizationId"),
    workitemId: z.string().describe("工作项唯一标识"),
    id: z.string().describe("工时记录唯一标识"),
    actualTime: z.number().positive().describe("实际工时"),
    description: z.string().max(500).optional().describe("工作描述"),
    gmtEnd: z.string().describe("工作开始结束日期"),
    gmtStart: z.string().describe("工作开始日期"),
    operatorId: z.string().optional().describe("操作者的useId，个人token时该参数无效"),
    workType: z.string().optional().describe("工作类型"),
  });