COS （对象存储 COS 与数据万象 CI）服务 MCP 接入

提供 COS/CI API 能力的 MCP 服务器，提供上传/下载对象、获取对象列表、文档转 pdf、图片文字水印、图片二维码识别、图片质量评分、图片超分、图片通用抠图、图片智能裁剪、智能检索 MetaInsight(文搜图、图搜图）、视频智能封面等能力

前往云开发平台 MCP Server

环境变量

需要将 SECRET_ID、 SECRET_KEY 配置为您在 API密码管理页面获取 SecretId、SecretKey
需要将 BUCKET 配置为存储桶名称
需要将 REGION 配置为存储桶所在的区域
需要将 DATASET_NAME 配置为智能检索的数据集名(非必填)

🗺️ 功能清单

工具标识	功能描述	核心参数
`putObject`	上传本地文件到存储桶(仅支持 server 本地文件)	`filePath`, `fileName`, `targetDir`
`putObjectSourceUrl`	通过 url下载文件并将文件上传到存储桶	`sourceUrl`, `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`

🔌 使用方式

云开发 MCP 控制台

参数说明

putObject

上传文件到存储桶

输入参数	Type	描述
filePath	string	文件路径（包含文件名）
fileName	optional string	文件名（存在存储桶里的名称）
targetDir	optional string	目标目录（存在存储桶的哪个目录）

返回: 对象地址

putObjectSourceUrl

通过 url下载文件并将文件上传到存储桶

输入参数	Type	描述
sourceUrl	string	可下载的文件 url
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 特有参数）

对象存储 COS

COS （对象存储 COS 与数据万象 CI）服务 MCP 接入

环境变量

🗺️ 功能清单

🔌 使用方式

参数说明

putObject

putObjectSourceUrl

getObject

getBucket

imageInfo

assessQuality

aiSuperResolution

aiPicMatting

aiQrcode

waterMarkFont

createMediaSmartCoverJob

describeMediaJob

imageSearchPic

imageSearchText

createDocToPdfJob

describeDocProcessJob

产品文档

SDK

教程视频

友情链接

关注或联系我们

对象存储 COS

COS （对象存储 COS 与数据万象 CI） 服务 MCP 接入

环境变量

🗺️ 功能清单

🔌 使用方式

参数说明

putObject

putObjectSourceUrl

getObject

getBucket

imageInfo

assessQuality

aiSuperResolution

aiPicMatting

aiQrcode

waterMarkFont

createMediaSmartCoverJob

describeMediaJob

imageSearchPic

imageSearchText

createDocToPdfJob

describeDocProcessJob

产品文档

SDK

教程视频

友情链接

关注或联系我们

COS （对象存储 COS 与数据万象 CI）服务 MCP 接入