AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/effort.ts:29-44 (handler)

  MCP tool handler switch case for 'create_effort_record': validates input using CreateEffortRecordSchema and calls effort.createEffortRecord from operations/projex/effort.ts

  case "create_effort_record": {
    const args = types.CreateEffortRecordSchema.parse(request.params.arguments);
    const result = await effort.createEffortRecord({
      id: args.id,
      organizationId: args.organizationId,
      actualTime: args.actualTime,
      description: args.description,
      gmtEnd: args.gmtEnd,
      gmtStart: args.gmtStart,
      operatorId: args.operatorId,
      workType: args.workType
    });
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }

• tool-registry/effort.ts:23-27 (registration)

  Registration of the 'create_effort_record' tool in getEffortTools array, specifying name, description, and input schema

  {
    name: "create_effort_record",
    description: "[Project Management] 登记实际工时",
    inputSchema: zodToJsonSchema(CreateEffortRecordSchema),
  },

• operations/projex/effort.ts:51-74 (helper)

  Core helper function implementing createEffortRecord: API POST to create effort record via yunxiaoRequest, using CreateEffortRecordRequestSchema

  export async function createEffortRecord(
    params: z.infer<typeof CreateEffortRecordRequestSchema> & {
      id: string;
      organizationId: 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.id}/effortRecords`;
    
    const response = await yunxiaoRequest(url, {
      method: "POST",
      body: validatedParams
    });
  
    return IdentifierDTOSchema.parse(response);
  }

• operations/projex/types.ts:522-531 (schema)

  Input schema CreateEffortRecordSchema: Zod object used for tool argument validation in handler and registration

  export const CreateEffortRecordSchema = z.object({
    id: z.string().describe("工作项唯一标识"),
    organizationId: z.string().describe("organizationId"),
    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("工作类型"),
  });

• operations/projex/types.ts:493-500 (schema)

  Internal API request schema CreateEffortRecordRequestSchema: Zod object used for validating body in createEffortRecord helper

  export const CreateEffortRecordRequestSchema = z.object({
    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("工作类型"),
  });