AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/organization.ts:30-39 (handler)

  MCP tool handler for get_organization_department_ancestors: parses input args using schema, calls the core helper function, and formats response as JSON text.

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

• operations/organization/types.ts:22-25 (schema)

  Zod schema defining input parameters: organizationId and department id.

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

• tool-registry/organization.ts:31-35 (registration)

  Tool registration entry with name, description, and JSON schema derived from Zod schema.

  {
    name: "get_organization_department_ancestors",
    description: "Get the ancestors of a department in an organization",
    inputSchema: zodToJsonSchema(types.GetOrganizationDepartmentAncestorsSchema),
  },

• operations/organization/organization.ts:85-93 (helper)

  Helper function that constructs API URL, makes GET request to fetch department ancestors, and parses response using schema.

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