COS （对象存储 COS 与数据万象 CI） 服务 MCP 接入
提供 COS/CI API 能力的 MCP 服务器，提供上传/下载对象、获取对象列表、文档转 pdf、图片文字水印、图片二维码识别、图片质量评分、图片超分、图片通用抠图、图片智能裁剪、智能检索 MetaInsight(文搜图、图搜图）、视频智能封面等能力
环境变量
- 需要将 SECRET_ID、 SECRET_KEY 配置为您在 API密码管理页面获取 SecretId、SecretKey
- 需要将 BUCKET 配置为存储桶名称
- 需要将 REGION 配置为存储桶所在的区域
- 需要将 DATASET_NAME 配置为智能检索的数据集名
🗺️ 功能清单
| 工具标识 | 功能描述 | 核心参数 |
|---|---|---|
putObject | 上传文件到存储桶 | filePath, fileName, targetDir |
getObject | 下载存储桶内的文件 | objectKey |
getBucket | 获取指定存储桶的文件列表 | Prefix |
imageInfo | 获取图片信息 | objectKey |
assessQuality | 图片质量评估 | objectKey |
aiSuperResolution | 图片超分辨率处理 | objectKey |
aiPicMatting | 图片抠图处理 | objectKey, width, height |
aiQrcode | 二维码识别 | objectKey |
waterMarkFont | 生成带文字水印的图片 | objectKey, text |
createMediaSmartCoverJob | 创建媒体智能封面任务 | objectKey |
describeMediaJob | 查询媒体智能封面任务结果 | jobId |
imageSearchPic | 根据图片检索相似图片 | uri |
imageSearchText | 根据文本检索相似图片 | text |
createDocToPdfJob | 创建文档转 PDF 处理任务 | objectKey |
describeDocProcessJob | 查询文档转码任务结果 | jobId |
🔌 使用方式
参数说明
putObject
上传文件到存储桶
| 输入参数 | Type | 描述 |
|---|---|---|
| filePath | string | 文件路径（包含文件名） |
| fileName | optional string | 文件名 （存在存储桶里的名称） |
| targetDir | optional string | 目标目录 （存在存储桶的哪个目录） |
返回: 对象地址
getObject
下载存储桶内的文件
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 文件的路径 |
返回: 文件内容
getBucket
获取指定仓库信息
| 输入参数 | Type | 描述 |
|---|---|---|
| Prefix | optional string | 文件列表的路径前缀,默认根路径 |
返回: 在桶中的文件列表
imageInfo
图片处理-获取图片信息
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 图片在存储桶里的路径 |
返回: | 输出参数 | 描述 | | -------- | ------------------------- | | format | 图片类型。例如 png、gif 等 | | width | 图片的宽度。单位为像素（px） | | height | 图片的高度。单位为像素（px） | | size | 图片的大小。单位为 Bytes | | md5 | 图片的 md5 值 | | frame_count | 图片的帧数。静态图为1，动图为对应的帧数 | | bit_depth | 图片的位深 | | vertical_dpi | 图片的垂直分辨率 | | horizontal_dpi | 图片的水平分辨率 |
assessQuality
图片处理-图片质量评估
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 图片在存储桶里的路径 |
返回:
| 输出参数 | 描述 |
|---|---|
| LongImage | 长图（长宽比 ≥3 或 ≤1/3），TRUE 表示是，FALSE 表示否 |
| BlackAndWhite | 黑白图（灰度图，RGB 三通道均为灰度色阶），TRUE 表示是，FALSE 表示否 |
| SmallImage | 小图（最长边 <179 像素），TRUE 表示是，此时其他字段输出为 0 或 FALSE |
| BigImage | 大图（最短边 >1000 像素），TRUE 表示是，FALSE 表示否 |
| PureImage | 纯色图/纯文字图（无内容或内容简单），TRUE 表示是，FALSE 表示否 |
| ClarityScore | 清晰度得分（0-100，综合噪声/曝光/模糊/压缩等评估，≥50 较清晰） |
| AestheticScore | 美观度得分（0-100，构图/色彩等艺术性评估，≥50 较美观） |
| LowQualityScore | 内容质量得分（0-100，背景/内容等质量评估，≥50 质量较好） |
| RequestId | 唯一请求 ID，用于问题定位 |
aiSuperResolution
图片处理-超分辨率
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 图片在存储桶里的路径 |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| UploadResult | 无 | 请求结果容器 |
| OriginalInfo | UploadResult | 原图信息容器 |
| Key | OriginalInfo | 原图文件名（如：example.jpg） |
| Location | OriginalInfo | 原图存储路径 |
| ETag | OriginalInfo | 原图文件的唯一标识符 |
| ProcessResults | UploadResult | 图片处理结果容器 |
| Object | ProcessResults | 单张图片处理结果容器 |
| Key | Object | 超分后图片文件名（如：output.jpg） |
| Location | Object | 超分后图片访问链接 |
| ETag | Object | 超分后图片的唯一标识符 |
| Size | Object | 超分后图片大小（单位：字节） |
aiPicMatting
图片处理-抠图
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 图片在存储桶里的路径 |
| width | optional string | 宽度 |
| height | optional string | 高度 |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| UploadResult | 无 | 请求结果容器 |
| OriginalInfo | UploadResult | 原图信息容器 |
| Key | OriginalInfo | 原图文件名（如：example.jpg） |
| Location | OriginalInfo | 原图存储路径 |
| ETag | OriginalInfo | 原图ETag 值 |
| ProcessResults | UploadResult | 图片处理结果容器 |
| Object | ProcessResults | 单张图片处理结果容器 |
| Key | Object | 抠图后图片文件名（如：output.jpg） |
| Location | Object | 抠图后图片链接 |
| ETag | Object | 抠图后图片的ETag 值 |
| Size | Object | 抠图后图片大小（单位：字节） |
aiQrcode
图片处理-二维码识别-识别存储桶内二维码图片内容
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | COS对象键（完整路径）示例: images/qrcode.jpg |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| UploadResult | 无 | 原图信息容器 |
| OriginalInfo | UploadResult | 原图信息容器 |
| Key | OriginalInfo | 原图文件名 |
| Location | OriginalInfo | 图片路径 |
| ImageInfo | OriginalInfo | 原图图片信息容器 |
| Format | ImageInfo | 图片格式 |
| Width | ImageInfo | 图片宽度 |
| Height | ImageInfo | 图片高度 |
| Quality | ImageInfo | 图片质量 |
| Ave | ImageInfo | 图片主色调 |
| Orientation | ImageInfo | 图片旋转角度 |
| ProcessResults | UploadResult | 图片处理结果容器 |
| Object | ProcessResults | 单条处理结果容器 |
| Key | Object | 处理后文件名 |
| Location | Object | 处理后图片路径 |
| Format | Object | 处理后图片格式 |
| Width | Object | 处理后图片宽度 |
| Height | Object | 处理后图片高度 |
| Size | Object | 处理后图片大小 |
| Quality | Object | 处理后图片质量 |
| codeStatus | Object | 二维码识别状态（0无/1有） |
| QRcodeInfo | Object | 二维码识别结果容器 |
| codeUrl | QRcodeInfo | 二维码解析内容 |
| codelocation | QRcodeInfo | 二维码坐标容器 |
| point | codelocation | 坐标点（格式: x1,y1;x2,y2;...） |
waterMarkFont
生成带文字水印的图片
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | COS对象键（完整路径）示例: images/photo.jpg |
| text | string | 水印文字内容（支持中文） |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| UploadResult | 无 | 原图信息（请求结果容器） |
| OriginalInfo | UploadResult | 原图信息容器 |
| Key | OriginalInfo | 原图文件名 |
| Location | OriginalInfo | 图片路径 |
| ImageInfo | OriginalInfo | 原图图片信息容器 |
| ETag | OriginalInfo | 原图/结果图 ETag 信息（覆盖时更新） |
| Format | ImageInfo | 图片格式 |
| Width | ImageInfo | 图片宽度（单位：像素） |
| Height | ImageInfo | 图片高度（单位：像素） |
| Quality | ImageInfo | 图片质量（数值） |
| Ave | ImageInfo | 图片主色调（十六进制格式 0xRRGGBB） |
| Orientation | ImageInfo | 图片旋转角度（1-8对应不同旋转/翻转模式） |
| FrameCount | ImageInfo | 图片帧数（静态图=1，动图为实际帧数） |
| ProcessResults | UploadResult | 图片处理结果容器 |
| Object | ProcessResults | 单个图片处理结果容器 |
| Key | Object | 结果图文件名 |
| Location | Object | 结果图路径 |
| Format | Object | 结果图格式 |
| Width | Object | 结果图宽度（单位：像素） |
| Height | Object | 结果图高度（单位：像素） |
| Size | Object | 结果图大小（单位：字节） |
| Quality | Object | 结果图质量（数值） |
| ETag | Object | 处理结果图 ETag 信息 |
| FrameCount | Object | 结果图帧数（静态图=1，动图为实际帧数） |
createMediaSmartCoverJob
创建媒体智能封面任务
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 对象在存储桶里的路径 |
返回 | 输出参数节点名称 | 父结点 | 描述 | |------------------|-----------------------------------------|---------------------------------------| | Response | 无 | 保存结果的容器 | | JobsDetail | Response | 任务的详细信息 | | Code | Response.JobsDetail | 错误码，只有 State 为 Failed 时有意义 | | Message | Response.JobsDetail | 错误描述，只有 State 为 Failed 时有意义 | | JobId | Response.JobsDetail | 新创建任务的 ID | | Tag | Response.JobsDetail | 新创建任务的 Tag：SmartCover | | State | Response.JobsDetail | 任务状态 | | CreationTime | Response.JobsDetail | 任务的创建时间 | | EndTime | Response.JobsDetail | 任务的结束时间 | | QueueId | Response.JobsDetail | 任务所属的队列 ID | | Input | Response.JobsDetail | 该任务的输入资源地址 | | Operation | Response.JobsDetail | 该任务的规则 | | Region | Response.JobsDetail.Input | 存储桶的地域 | | Bucket | Response.JobsDetail.Input | 存储结果的存储桶 | | Object | Response.JobsDetail.Input | 输出结果的文件名 | | SmartCover | Response.JobsDetail.Operation | 同请求中的 Request.Operation.SmartCover | | Output | Response.JobsDetail.Operation | 同请求中的 Request.Operation.Output | | MediaResult | Response.JobsDetail.Operation | 输出文件的基本信息，任务未完成时不返回，详见 MediaResult | | UserData | Response.JobsDetail.Operation | 透传用户信息 | | JobLevel | Response.JobsDetail.Operation | 任务优先级 | | OutputFile | Response.JobsDetail.Operation.MediaResult | 输出文件的基本信息 | | Bucket_OutputFile| Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件所在的存储桶 | | Region_OutputFile| Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件所在的存储桶所在的园区 | | ObjectName | Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件名，可能有多个 | | Md5Info | Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件的 MD5 信息 | | ObjectName_MD5 | Response.JobsDetail.Operation.MediaResult.OutputFile.Md5Info | 输出文件名（带 MD5 后缀） | | Md5 | Response.JobsDetail.Operation.MediaResult.OutputFile.Md5Info | 输出文件的 MD5 值 |
describeMediaJob
根据 jobid 查询指定的媒体智能封面任务结果
| 输入参数 | Type | 描述 |
|---|---|---|
| jobId | string | 要查询的任务ID，可通过提交智能封面任务的响应中获取。 |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| Response | 无 | 保存结果的容器 |
| JobsDetail | Response | 任务的详细信息 |
| Code | Response.JobsDetail | 错误码，只有 State 为 Failed 时有意义 |
| Message | Response.JobsDetail | 错误描述，只有 State 为 Failed 时有意义 |
| JobId | Response.JobsDetail | 新创建任务的 ID |
| Tag | Response.JobsDetail | 新创建任务的 Tag：SmartCover |
| State | Response.JobsDetail | 任务状态 |
| CreationTime | Response.JobsDetail | 任务的创建时间 |
| EndTime | Response.JobsDetail | 任务的结束时间 |
| QueueId | Response.JobsDetail | 任务所属的队列 ID |
| Input | Response.JobsDetail | 该任务的输入资源地址 |
| Operation | Response.JobsDetail | 该任务的规则 |
| Region | Response.JobsDetail.Input | 存储桶的地域 |
| Bucket | Response.JobsDetail.Input | 存储结果的存储桶 |
| Object | Response.JobsDetail.Input | 输出结果的文件名 |
| SmartCover | Response.JobsDetail.Operation | 同请求中的 Request.Operation.SmartCover |
| Output | Response.JobsDetail.Operation | 同请求中的 Request.Operation.Output |
| MediaResult | Response.JobsDetail.Operation | 输出文件的基本信息，任务未完成时不返回，详见 MediaResult |
| UserData | Response.JobsDetail.Operation | 透传用户信息 |
| JobLevel | Response.JobsDetail.Operation | 任务优先级 |
| OutputFile | Response.JobsDetail.Operation.MediaResult | 输出文件的基本信息 |
| Bucket_OutputFile | Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件所在的存储桶 |
| Region_OutputFile | Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件所在的存储桶所在的园区 |
| ObjectName | Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件名，可能有多个 |
| Md5Info | Response.JobsDetail.Operation.MediaResult.OutputFile | 输出文件的 MD5 信息 |
| ObjectName_Info | Response.JobsDetail.Operation.MediaResult.OutputFile.Md5Info | 输出文件名（带 MD5 后缀） |
| Md5_Value | Response.JobsDetail.Operation.MediaResult.OutputFile.Md5Info | 输出文件的 MD5 值 |
imageSearchPic
根据输入的图片，从数据集中检索出与输入的图片内容相似的图片
| 输入参数 | Type | 描述 |
|---|---|---|
| uri | string | 根据输入的图片，从数据集中检索出与输入的图片内容相似的图片 |
返回: | 输出参数节点名称 | 父结点 | 描述 | | -------- | --------------- | ------------------------- | | ImageResult | 无 | 图像检索识别结果信息列表 | | RequestId | 无 | 请求 ID | | URI | ImageResult | 相似的图片地址 | | Score | ImageResult | 图片相关度分数，分数越高表示与检索条件越相符 |
imageSearchText
根据输入的文本内容，从数据集中检索出与输入的文本内容相符的图片
| 输入参数 | Type | 描述 |
|---|---|---|
| text | string | 检索的文本 |
返回: | 输出参数节点名称 | 父结点 | 描述 | | -------- | --------------- | ------------------------- | | ImageResult | 无 | 图像检索识别结果信息列表 | | RequestId | 无 | 请求 ID | | URI | ImageResult | 相似的图片地址 | | Score | ImageResult | 图片相关度分数，分数越高表示与检索条件越相符 |
createDocToPdfJob
创建文档转 pdf 处理任务
| 输入参数 | Type | 描述 |
|---|---|---|
| objectKey | string | 对象在存储桶里的路径 |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| Response | 无 | 保存结果的容器 |
| JobsDetail | Response | 任务的详细信息，同 CreateDocProcessJobs 接口的 Response.JobsDetail 节点 |
| NonExistJobIds | Response | 查询的 ID 中不存在的任务，所有任务都存在时不返回 |
| DocProcess | Response.JobsDetail.Operation | 文档预览任务参数 |
| DocProcessResult | Response.JobsDetail.Operation | 在 job 类型为 DocProcess 且状态为 success 时，返回文档预览任务结果详情 |
| Output | Response.JobsDetail.Operation | 结果输出地址，同 CreateDocProcessJobs 接口的 Request.Operation.Output 节点 |
| PageInfo | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物详情 |
| TgtType | Response.JobsDetail.Operation.DocProcessResult | 预览产物目标格式 |
| TotalPageCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物的总数 |
| SuccPageCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物的成功数 |
| FailPageCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物的失败数 |
| TotalSheetCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务的 Sheet 总数（Excel 特有参数） |
| PageNo | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 预览产物页码/SheetId（Excel 格式时） |
| TgtUri | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 预览产物生成的 COS 桶路径 |
| X-SheetPics | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 当前 Sheet 生成的图片总数（Excel 特有参数） |
| PicIndex | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 当前预览产物在整个源文件中的序号（Excel 特有参数） |
| PicNum | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 当前预览产物在 Sheet 中的序号（Excel 特有参数） |
describeDocProcessJob
根据 jobid 查询指定的文档转码任务结果
| 输入参数 | Type | 描述 |
|---|---|---|
| jobId | string | 要查询的任务ID，可通过提交文档任务的响应中获取。 |
返回:
| 输出参数节点名称 | 父结点 | 描述 |
|---|---|---|
| Response | 无 | 保存结果的容器 |
| JobsDetail | Response | 任务的详细信息，同 CreateDocProcessJobs 接口的 Response.JobsDetail 节点 |
| NonExistJobIds | Response | 查询的 ID 中不存在的任务，所有任务都存在时不返回 |
| DocProcess | Response.JobsDetail.Operation | 文档预览任务参数 |
| DocProcessResult | Response.JobsDetail.Operation | 在 job 类型为 DocProcess 且状态为 success 时，返回文档预览任务结果详情 |
| Output | Response.JobsDetail.Operation | 结果输出地址，同 CreateDocProcessJobs 接口的 Request.Operation.Output 节点 |
| PageInfo | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物详情 |
| TgtType | Response.JobsDetail.Operation.DocProcessResult | 预览产物目标格式 |
| TotalPageCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物的总数 |
| SuccPageCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物的成功数 |
| FailPageCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务产物的失败数 |
| TotalSheetCount | Response.JobsDetail.Operation.DocProcessResult | 预览任务的 Sheet 总数（Excel 特有参数） |
| PageNo | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 预览产物页码/SheetId（Excel 格式时） |
| TgtUri | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 预览产物生成的 COS 桶路径 |
| X-SheetPics | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 当前 Sheet 生成的图片总数（Excel 特有参数） |
| PicIndex | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 当前预览产物在整个源文件中的序号（Excel 特有参数） |
| PicNum | Response.JobsDetail.Operation.DocProcessResult.PageInfo | 当前预览产物在 Sheet 中的序号（Excel 特有参数） |