Qiniu MCP Server
Description
# Qiniu MCP Server ## 概述 基于七牛云产品构建的 Model Context Protocol (MCP) Server，支持用户在 AI 大模型客户端的上下文中通过该 MCP Server 来访问七牛云存储、智能多媒体，直播服务等。 能力集： - 存储 - 获取 Bucket 列表 - 获取 Bucket 中的文件列表 - 上传本地文件，以及给出文件内容进行上传 - 读取文件内容 - 获取文件下载链接 - 关于访问七牛云存储详细情况请参考 [基于 MCP…
About
# Qiniu MCP Server ## 概述 基于七牛云产品构建的 Model Context Protocol (MCP) Server，支持用户在 AI 大模型客户端的上下文中通过该 MCP Server 来访问七牛云存储、智能多媒体，直播服务等。 能力集： - 存储 - 获取 Bucket 列表 - 获取 Bucket 中的文件列表 - 上传本地文件，以及给出文件内容进行上传 - 读取文件内容 - 获取文件下载链接 - 关于访问七牛云存储详细情况请参考 [基于 MCP 使用大模型访问七牛云存储](https://developer.qiniu.com/kodo/12914/mcp-aimodel-kodo)。 -…
Details
- Author
- qiniu
- GitHub stars
- 38
- Downloads
- 520
- Categories
- File Management, Media, Other
Jump to
- List and manage storage buckets and files.
- Upload local files and read file contents.
- Generate file download links.
- Resize and round-corner images.
- Refresh and prefetch CDN by URL.
- Manage live streaming spaces, streams, and domains.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Qiniu MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.12+ and the uv package manager. In an MCP client like Cline, configure the server by adding a JSON block (command: uvx, args: ["qiniu-mcp-server"]) and set environment variables for your Qiniu credentials (QINIU_ACCESS_KEY, QINIU_SECRET_KEY, QINIU_REGION_NAME, QINIU_ENDPOINT_URL, QINIU_BUCKETS). For live streaming only, you may substitute with QINIU_LIVE_API_KEY. Connect the server, then interact with the AI to run actions like listing buckets or managing live streams.
version
qiniu mcp server version info.
list_buckets
Return the Bucket you configured based on the conditions.
list_objects
List objects in Qiniu Cloud, list a part each time, you can set start_after to continue listing, when the number of listed objects is less than max_keys, it means that all files are listed. start_after can be the key of the last file in the previous listing.
get_object
Get an object contents from Qiniu Cloud bucket. In the GetObject request, specify the full key name for the object.
upload_text_data
Upload text data to Qiniu bucket.
upload_local_file
Upload a local file to Qiniu bucket.
get_object_url
Get the file download URL, and note that the Bucket where the file is located must be bound to a domain name. If using Qiniu Cloud test domain, HTTPS access will not be available, and users need to make adjustments for this themselves.
cdn_refresh
This function marks resources cached on CDN nodes as expired. When users access these resources again, the CDN nodes will fetch the latest version from the origin server and store them anew.
cdn_prefetch_urls
Newly added resources are proactively retrieved by the CDN and stored on its cache nodes in advance. Users simply submit the resource URLs, and the CDN automatically triggers the prefetch process.
image_scale_by_percent
Image scaling tool that resizes images based on a percentage and returns information about the scaled image. The information includes the object_url of the scaled image, which users can directly use for HTTP GET requests to retrieve the image content or open in a browser to view the file. The image must be stored in a Qiniu Cloud Bucket. Supported original image formats: psd, jpeg, png, gif, webp, tiff, bmp, avif, heic. Image width and height cannot exceed 30,000 pixels, and total pixels cannot exceed 150 million.
image_scale_by_size
Image scaling tool that resizes images based on a specified width or height and returns information about the scaled image. The information includes the object_url of the scaled image, which users can directly use for HTTP GET requests to retrieve the image content or open in a browser to view the file. The image must be stored in a Qiniu Cloud Bucket. Supported original image formats: psd, jpeg, png, gif, webp, tiff, bmp, avif, heic. Image width and height cannot exceed 30,000 pixels, and total pixels cannot exceed 150 million.
image_round_corner
Image rounded corner tool that processes images based on width, height, and corner radius, returning information about the processed image. If only radius_x or radius_y is set, the other parameter will be assigned the same value, meaning horizontal and vertical parameters will be identical. The information includes the object_url of the processed image, which users can directly use for HTTP GET requests to retrieve the image content or open in a browser to view the file. The image must be stored in a Qiniu Cloud Bucket. Supported original image formats: psd, jpeg, png, gif, webp, tiff, bmp, avif, heic. Image width and height cannot exceed 30,000 pixels, and total pixels cannot exceed 150 million. Corner radius supports pixels and percentages, but cannot be negative. Pixels are represented by numbers, e.g., 200 means 200px; percentages use !xp, e.g., !25p means 25%.
image_info
Retrieves basic image information, including image format, size, and color model.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"qiniu mcp server": {
"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": ""
},
"disabled": false
}
}
}
}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": ""
},
"disabled": false
}
}Qiniu MCP Server
概述
基于七牛云产品构建的 Model Context Protocol (MCP) Server，支持用户在 AI 大模型客户端的上下文中通过该 MCP
Server 来访问七牛云存储、智能多媒体，直播服务等。
能力集：
- 存储
- 获取 Bucket 列表
- 获取 Bucket 中的文件列表
- 上传本地文件，以及给出文件内容进行上传
- 读取文件内容
- 获取文件下载链接
- 关于访问七牛云存储详细情况请参考 基于 MCP 使用大模型访问七牛云存储。
- 智能多媒体
- 图片缩放
- 图片切圆角
- CDN
- 根据链接刷新文件
- 根据链接预取文件
- 直播
- 创建直播空间bucket
- 创建直播流
- 获取直播空间列表
- 获取流列表
- 绑定推拉流域名
- 获取推拉流直播地址
- 获取直播用量
环境要求
- Python 3.12 或更高版本
- uv 包管理器
如果还没有安装 uv，可以使用以下命令安装：
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
