AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/effort.ts:46-55 (handler)

  MCP tool handler implementation for 'list_estimated_efforts'. Parses input arguments using the schema, calls the underlying effort service function, and formats the response as JSON text.

  case "list_estimated_efforts": {
    const args = types.ListEstimatedEffortsSchema.parse(request.params.arguments);
    const estimatedEfforts = await effort.listEstimatedEfforts({
      id: args.id,
      organizationId: args.organizationId
    });
    return {
      content: [{ type: "text", text: JSON.stringify(estimatedEfforts, null, 2) }],
    };
  }

• operations/projex/effort.ts:77-89 (helper)

  Core helper function that performs the API request to fetch estimated efforts for a workitem and parses the response using Zod.

  export async function listEstimatedEfforts(
    params: z.infer<typeof ListEstimatedEffortsSchema>
  ) {
    const validatedParams = ListEstimatedEffortsSchema.parse(params);
    
    const url = `/oapi/v1/projex/organizations/${validatedParams.organizationId}/workitems/${validatedParams.id}/estimatedEfforts`;
    
    const response = await yunxiaoRequest(url, {
      method: "GET"
    });
  
    return z.array(EstimatedEffortSchema).parse(response);
  }

• tool-registry/effort.ts:29-32 (registration)

  Tool registration in the effort tools array, including name, description, and input schema converted to JSON schema.

    name: "list_estimated_efforts",
    description: "[Project Management] 获取预计工时明细",
    inputSchema: zodToJsonSchema(ListEstimatedEffortsSchema),
  },

• operations/projex/types.ts:533-537 (schema)

  Zod schema definition for input parameters: workitem id and organizationId.

  export const ListEstimatedEffortsSchema = z.object({
    id: z.string().describe("工作项唯一标识"),
    organizationId: z.string().describe("organizationId"),
  });