AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/organization.ts:98-107 (handler)

  Tool handler implementation: parses input arguments using the schema, calls the core getOrganizationRoleFunc, and returns the role as JSON string.

  case "get_organization_role": {
    const args = types.GetOrganizationRoleSchema.parse(request.params.arguments);
    const role = await organization.getOrganizationRoleFunc(
      args.organizationId,
      args.roleId
    );
    return {
      content: [{ type: "text", text: JSON.stringify(role, null, 2)}]
    }
  }

• operations/organization/organization.ts:107-118 (helper)

  Core helper function that makes the API request to fetch the organization role and parses the response with OrganizationRoleSchema.

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

• tool-registry/organization.ts:62-65 (registration)

  Tool registration defining the name, description, and input schema.

    name: "get_organization_role",
    description: "[Organization Management] Get information about an organization role",
    inputSchema: zodToJsonSchema(types.GetOrganizationRoleSchema),
  },

• operations/organization/types.ts:16-19 (schema)

  Input schema for the tool defining organizationId and roleId parameters.

  export const GetOrganizationRoleSchema = z.object({
    organizationId: z.string().describe("Organization ID"),
    roleId: z.string().describe("Role ID")
  });

• operations/organization/types.ts:4-9 (schema)

  Output schema defining the structure of the organization role object.

  export const OrganizationRoleSchema = z.object({
    id: z.string().describe("Role ID"),
    name: z.string().describe("Role name"),
    organizationId: z.string().describe("Organization ID"),
    permissions: z.array(z.string()).describe("Role permission list")
  });