
Qiniu MCP Server
Access Qiniu Cloud storage, smart multimedia, CDN, and live streaming from your AI client.
Add to your client
Copy the config for your MCP client and paste it into its config file.
uvx qiniu-mcp-serverPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"qiniu-mcp-server": {
"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"
}
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Python 3.12 or higher
- uv package manager
- Qiniu Cloud account with Access Key and Secret Key (or a live API key for live-only usage)
About Qiniu MCP Server
Qiniu MCP Server exposes Qiniu Cloud (七牛云) capabilities to AI clients through the Model Context Protocol. It covers object storage (Kodo), intelligent multimedia processing, CDN refresh/prefetch, and live streaming management. It is configured via uvx with Qiniu credentials and works in Cline, Cursor, and Claude.
Tools & capabilities (16)
List bucketsGet the list of Qiniu storage buckets.
List filesGet the list of files in a bucket.
Upload fileUpload a local file, or upload provided file content.
Read fileRead the contents of a file.
Get download linkGet a download link for a file.
Resize imageScale/resize an image via Qiniu intelligent multimedia.
Round image cornersApply rounded corners to an image.
CDN refreshRefresh a file on the CDN by its URL.
CDN prefetchPrefetch a file to the CDN by its URL.
Create live spaceCreate a live space (bucket).
Create live streamCreate a live stream.
List live spacesGet the list of live spaces.
List streamsGet the list of streams.
Bind push/pull domainsBind push and pull streaming domains.
Get live addressesGet the push and pull live streaming addresses.
Get live usageGet live streaming usage statistics.
What this server can do
Qiniu MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- List Qiniu buckets and browse files in a bucket from an AI assistant
- Read or upload files to Qiniu Cloud storage and generate download links
- Resize images or apply rounded corners using Qiniu intelligent multimedia
- Refresh or prefetch CDN URLs
- Create and manage live streaming spaces, streams, domains, and check live usage
Security notes
Requires Qiniu Cloud credentials (QINIU_ACCESS_KEY / QINIU_SECRET_KEY) supplied via environment variables; treat them as secrets. For live-only usage a QINIU_LIVE_API_KEY from the Qiniu live console can be used instead. In Claude you may hit 'Error: spawn uvx ENOENT' — set the command to the absolute path of uvx (e.g. /usr/local/bin/uvx).
Qiniu MCP Server FAQ
How do I install it?
Add the mcpServers config with command 'uvx' and args ['qiniu-mcp-server'] to your client (Cline, Cursor, or Claude), supplying your Qiniu credentials via env. uvx will fetch and run the server.
What credentials are required?
QINIU_ACCESS_KEY and QINIU_SECRET_KEY (plus QINIU_REGION_NAME, QINIU_ENDPOINT_URL, and QINIU_BUCKETS for storage). For live-only usage you can instead set QINIU_LIVE_API_KEY obtained from the Qiniu live console.
Does it support SSE?
Yes. The default transport is stdio, but you can start it in SSE mode for web apps with 'uv --directory . run qiniu-mcp-server --transport sse --port 8000'.
I get 'Error: spawn uvx ENOENT' in Claude. How do I fix it?
Set the command to the absolute path of uvx, for example /usr/local/bin/uvx.
Alternatives to Qiniu MCP Server
Compare all alternatives →Official MCP reference server for secure local filesystem read/write within allowed directories.
Official MCP server for reading, searching, and manipulating a local Git repository's files and history.
Official AWS Labs MCP server to manage and query S3 Tables (table buckets, namespaces, tables).
Compare Qiniu MCP Server with: