XMZ MCP Server

Instructions

Implementation Reference

• src/services/ci/media.service.ts:138-176 (handler)

  The core handler function that performs the actual API call to query the media job status using the COS client.

  async describeMediaJob(jobId: string) {
    try {
      let host = this.bucket + '.ci.' + this.region + '.myqcloud.com';
      let url = 'https://' + host + '/doc_jobs/' + jobId;
      const result = await new Promise((resolve, reject) => {
        this.cos.request(
          {
            Bucket: this.bucket, // Bucket 格式：test-1250000000
            Region: this.region,
            Method: 'GET',
            Key: 'doc_jobs/' + jobId,
            Url: url,
          },
          function (error, data) {
            if (error) {
              // 处理请求失败
              reject(error);
            } else {
              // 处理请求成功
              resolve(data);
              //获取返回的jobid， 去调查询任务接口， 返回具体信息
            }
          },
        );
      });
  
      return {
        isSuccess: true,
        message: '智能封面任务查询成功',
        data: result,
      };
    } catch (error) {
      return {
        isSuccess: false,
        message: '智能封面任务查询失败',
        data: error,
      };
    }
  }

• src/server.ts:467-487 (registration)

  MCP tool registration, including input schema (Zod) and thin wrapper handler that delegates to the service implementation.

  server.tool(
    'describeMediaJob',
    '根据 jobid 查询指定的媒体智能封面任务结果',
    {
      jobId: z
        .string()
        .describe('要查询的任务ID，可通过提交智能封面任务的响应中获取。'),
    },
    async ({ jobId }) => {
      const res = await CIMediaInstance.describeMediaJob(jobId);
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(res.data, null, 2),
          },
        ],
        isError: !res.isSuccess,
      };
    },
  );

• src/server.ts:470-474 (schema)

  Input schema definition using Zod for the jobId parameter.

  {
    jobId: z
      .string()
      .describe('要查询的任务ID，可通过提交智能封面任务的响应中获取。'),
  },