Alibaba Cloud FC MCP Server

Instructions

Implementation Reference

• src/index.ts:540-583 (handler)

  The handler function that implements the core logic of the 'get-function' tool. It retrieves detailed information about a specific function from Alibaba Cloud Function Compute (FC), including checks for custom domain configuration, using the FC SDK client.

  async (args) => {
      const { functionName, region } = args;
      const accessKeyId = process.env.ALIBABA_CLOUD_ACCESS_KEY_ID;
      const accessKeySecret = process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET;
      if (!accessKeyId || !accessKeySecret) {
          return { isError: true, content: [{ type: "text", text: `执行失败，请设置ALIBABA_CLOUD_ACCESS_KEY_ID, ALIBABA_CLOUD_ACCESS_KEY_SECRET, ALIBABA_CLOUD_SECURITY_TOKEN环境变量` }] };
      }
      const accountId = await getAccountId();
      if (!accountId) {
          return { isError: true, content: [{ type: "text", text: `执行失败，获取accountId异常` }] };
      }
      const fcClient = createFcClient(region);
      let getFunctionResult;
      try {
          const getFunctionRequest = new GetFunctionRequest({})
          getFunctionResult = await fcClient.getFunction(functionName, getFunctionRequest)
      } catch (error) {
          return { isError: true, content: [{ type: "text", text: `获取函数信息失败：${JSON.stringify(error as any)}` }] };
      }
  
      const functionInfo = {
          ...getFunctionResult.body,
      }
      const autoDomainName = getAutoCustomDomainName(accountId, functionName, region);
      let getCustomDomainResult;
      try {
          getCustomDomainResult = await fcClient.getCustomDomain(autoDomainName);
      } catch (error: any) {
          if (error.statusCode !== 404) {
              return { isError: true, content: [{ type: "text", text: `获取函数域名信息失败：${JSON.stringify(error as any)}` }] };
          }
          getCustomDomainResult = null;
      }
      if (getCustomDomainResult) {
          const routes = getCustomDomainResult.body?.routeConfig?.routes
          if (routes && routes.length == 1) {
              const route = routes[0];
              if (route.functionName == functionName) {
                  functionInfo.domain = autoDomainName;
              }
          }
      }
      return { content: [{ type: "text", text: `获取函数信息: ${JSON.stringify(functionInfo)}` }] };
  }

• src/index.ts:533-584 (registration)

  The registration of the 'get-function' MCP tool using server.tool(), including the tool name, description, input schema parameters (functionName and region), and inline handler.

  server.tool(
      "get-function",
      "获取创建的函数计算的函数信息",
      {
          functionName: functionNameSchema,
          region: regionSchema,
      },
      async (args) => {
          const { functionName, region } = args;
          const accessKeyId = process.env.ALIBABA_CLOUD_ACCESS_KEY_ID;
          const accessKeySecret = process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET;
          if (!accessKeyId || !accessKeySecret) {
              return { isError: true, content: [{ type: "text", text: `执行失败，请设置ALIBABA_CLOUD_ACCESS_KEY_ID, ALIBABA_CLOUD_ACCESS_KEY_SECRET, ALIBABA_CLOUD_SECURITY_TOKEN环境变量` }] };
          }
          const accountId = await getAccountId();
          if (!accountId) {
              return { isError: true, content: [{ type: "text", text: `执行失败，获取accountId异常` }] };
          }
          const fcClient = createFcClient(region);
          let getFunctionResult;
          try {
              const getFunctionRequest = new GetFunctionRequest({})
              getFunctionResult = await fcClient.getFunction(functionName, getFunctionRequest)
          } catch (error) {
              return { isError: true, content: [{ type: "text", text: `获取函数信息失败：${JSON.stringify(error as any)}` }] };
          }
  
          const functionInfo = {
              ...getFunctionResult.body,
          }
          const autoDomainName = getAutoCustomDomainName(accountId, functionName, region);
          let getCustomDomainResult;
          try {
              getCustomDomainResult = await fcClient.getCustomDomain(autoDomainName);
          } catch (error: any) {
              if (error.statusCode !== 404) {
                  return { isError: true, content: [{ type: "text", text: `获取函数域名信息失败：${JSON.stringify(error as any)}` }] };
              }
              getCustomDomainResult = null;
          }
          if (getCustomDomainResult) {
              const routes = getCustomDomainResult.body?.routeConfig?.routes
              if (routes && routes.length == 1) {
                  const route = routes[0];
                  if (route.functionName == functionName) {
                      functionInfo.domain = autoDomainName;
                  }
              }
          }
          return { content: [{ type: "text", text: `获取函数信息: ${JSON.stringify(functionInfo)}` }] };
      }
  )

• src/schema.ts:4-6 (schema)

  Zod schema definition for 'region' input parameter used in 'get-function' tool validation.

  export const regionSchema = z.enum(['cn-hangzhou', 'cn-shanghai', 'cn-beijing', 'cn-shenzhen', 'cn-hongkong', 'ap-southeast-1', 'ap-southeast-2', 'ap-southeast-3', 'ap-southeast-5', 'ap-northeast-1', 'eu-central-1', 'eu-west-1', 'us-west-1', 'us-east-1', 'ap-south-1', 'me-east-1', 'cn-chengdu', 'cn-wulanchabu', 'cn-guangzhou'])
      .default('cn-hangzhou')
      .describe("部署的区域，当前可选的区域是cn-hangzhou, cn-shanghai, cn-beijing, cn-shenzhen, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1, me-east-1, cn-chengdu, cn-wulanchabu, cn-guangzhou，默认是cn-hangzhou");

• src/schema.ts:119-120 (schema)

  Zod schema definition for 'functionName' input parameter used in 'get-function' tool validation.

  export const functionNameSchema = z.string().describe("函数名称，函数名称在每个region必须是唯一的。")
      .regex(/^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,63}$/);

• src/utils/alibaba_cloud_sdk.ts:11-17 (helper)

  Helper function to create an Alibaba Cloud FC client instance, used in the 'get-function' handler.

  export function createFcClient(regionId: string) {
    const config = new $OpenApi.Config({
      credential: getCredentialClient(),
      endpoint: `fcv3.${regionId}.aliyuncs.com`,
    });
    return new FCClient(config);
  }