qiniu-mcp-server 是一个基于七牛云产品构建的 Model Context Protocol（MCP）Server，其目标是在 AI 大模型客户端的上下文中，让用户通过该 MCP Server 访问七牛云存储、智能多媒体、直播服务等能力。
用途 该服务用于把七牛云的产品能力接入支持 MCP 的 AI 大模型客户端，使 AI 可以在对话中直接操作七牛云的相关资源。
主要能力 存储方面支持：获取 Bucket 列表、获取 Bucket 中的文件列表、上传本地文件以及给出文件内容进行上传、读取文件内容、获取文件下载链接。 智能多媒体方面支持：图片缩放、图片切圆角。 CDN 方面支持：根据链接刷新文件、根据链接预取文件。 直播方面支持：创建直播空间 bucket、创建直播流、获取直播空间列表、获取流列表、绑定推拉流域名、获取推拉流直播地址、获取直播用量。
使用方式 环境要求：Python 3.12 或更高版本；如果还没有安装 uv，可以使用相应命令安装（资料未给出具体安装命令内容）。 在 vscode 中下载 Cline 插件，下载后侧边栏会增加 Cline 的图标。 配置 qiniu MCP：点击 Cline 图标进入 Cline 插件，选择 MCP Server 模块，选择 installed，点击 Advanced MCP Settings 配置 MCP Server，参考配置信息如下： { "mcpServers": { "qiniu": { "command": "uvx", "args": [ "qiniu-mcp-server" ], "env": { "QINIU_ACCESS_KEY": "YOUR_ACCESS_KEY", "QINIU_SECRET_KEY": "YOUR_SECRET_KEY", "QINIU_REGION_NAME": "YOUR_REGION_NAME", "QINIU_ENDPOINT_URL": "YOUR_ENDPOINT_URL", "QINIU_BUCKETS": "YOUR_BUCKET_A,YOUR_BUCKET_B" }, "disabled": false } } } 如果只使用直播功能时，支持两种鉴权模式： 1 配置 QINIU_ACCESS_KEY/QINIU_SECRET_KEY： { "mcpServers": { "qiniu": { "command": "uvx", "args": [ "qiniu-mcp-server" ], "env": { "QINIU_ACCESS_KEY": "YOUR_ACCESS_KEY", "QINIU_SECRET_KEY": "YOUR_SECRET_KEY" }, "disabled": false } } } 2 可在七牛直播控制台获取 apikey 后，配置 QINIU_LIVE_API_KEY： { "mcpServers": { "qiniu": { "command": "uvx", "args": [ "qiniu-mcp-server" ], "env": { "QINIU_LIVE_API_KEY": "YOUR_LIVE_API_KEY" }, "disabled": false } } } 点击 qiniu MCP Server 的链接开关进行连接。
在 Cline 中创建一个聊天窗口，可以与 AI 进行交互来使用 qiniu-mcp-server。对象存储的示例如：列举 qiniu 中所有的 Bucket；列举 qiniu 中 xxx Bucket 的文件；读取 qiniu xxx Bucket 中 yyy 的文件内容；对 qiniu xxx Bucket 中 yyy 的图片切个宽 200 像素的圆角；刷新下 qiniu 的这个 CDN 链接：https://developer.qiniu.com/test.txt。 直播系统的示例如：列举所有的直播空间；新创建 1 个直播空间，命名为 mcptest1123；为 mcptest1123 新创建 1 个流，命名为 stream1；列举一下直播空间 mcptest1123 中所有的流；为 mcptest1123 绑定推流域名，绑定拉流域名；获取 mcptest1123 下直播流 stream1 对应的推流地址和拉流地址；获取最近 1 个小时直播的用量。
适用场景与限制 该 MCP Server 适用于在支持 MCP 的 AI 大模型客户端中访问和管理七牛云存储、智能多媒体、CDN 与直播相关资源。资料提到 cursor 中创建 MCP Server 可直接使用上述配置；claude 中使用时可能会遇到：Error: spawn uvx ENOENT 错误，解决方案：command 中参数填写 uvx 的绝对路径，eg: /usr/local/bin/uvx。
扩展与测试 扩展功能：首先在 core 目录下新增一个业务包目录（eg: 存储 -> storage），在此业务包目录下完成功能拓展；在业务包目录下的 init.py 文件中定义 load 函数用于注册业务工具或者资源，最后在 core 目录下的 init.py 中调用此 load 函数完成工具或资源的注册。 测试：强烈推荐使用 Model Control Protocol Inspector 进行测试。本地启动 MCP Server 示例：使用标准输入输出（stdio）模式启动（默认）；使用 SSE 模式启动（用于 Web 应用）。 编辑 .env 文件，配置以下参数（资料未列出具体参数内容）。
