AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/organization.ts:19-28 (handler)

  Tool handler that parses input arguments using the schema, calls the core getOrganizationDepartmentInfoFunc with organizationId and department id, and returns the result as JSON stringified text content.

  case "get_organization_department_info": {
    const args = types.GetOrganizationDepartmentInfoSchema.parse(request.params.arguments);
    const departmentInfo = await organization.getOrganizationDepartmentInfoFunc(
      args.organizationId,
      args.id
    )
    return {
      content: [{ type: "text", text: JSON.stringify(departmentInfo, null, 2) }],
    };
  }

• operations/organization/types.ts:27-30 (schema)

  Zod schema defining the input parameters for the tool: organizationId (string) and id (department ID, string).

  export const GetOrganizationDepartmentInfoSchema = z.object({
    organizationId: z.string().describe("Organization ID"),
    id: z.string().describe("Department ID"),
  });

• tool-registry/organization.ts:26-30 (registration)

  Registers the tool in the registry with name, description, and input schema derived from the Zod schema.

  {
    name: "get_organization_department_info",
    description: "Get information about a department in an organization",
    inputSchema: zodToJsonSchema(types.GetOrganizationDepartmentInfoSchema),
  },

• operations/organization/organization.ts:72-83 (helper)

  Core helper function that constructs the API URL using organizationId and department id, performs a GET request via yunxiaoRequest, and parses the response using DepartmentInfoSchema.

  export async function getOrganizationDepartmentInfoFunc(
    organizationId: string,
    id: string
  ): Promise<z.infer<typeof DepartmentInfoSchema>> {
    const url = `/oapi/v1/platform/organizations/${organizationId}/departments/${id}`;
  
    const response = await yunxiaoRequest(url, {
      method: "GET",
    });
  
    return DepartmentInfoSchema.parse(response);
  }