Qiniu MCP
The Model Context Protocol (MCP) Server built on Qiniu Cloud products supports users in accessing Qiniu Cloud Storage, intelligent multimedia services, and more through this MCP Server within the context of AI large model clients.
What is Qiniu MCP?
Qiniu MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server built on qiniu cloud products supports users in accessing qiniu cloud storage, intelligent multimedia services, and more through this mcp server within the context ...
The Model Context Protocol (MCP) Server built on Qiniu Cloud products supports users in accessing Qiniu Cloud Storage, intelligent multimedia services, and more through this MCP Server within the context of AI large model clients.
This server falls under the Cloud Services and File Systems categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- The Model Context Protocol (MCP) Server built on Qiniu Cloud
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx qiniu-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Qiniu MCP
Qiniu MCP Server brings Qiniu Cloud's storage, multimedia processing, CDN, and live streaming services into AI model conversations via the Model Context Protocol. It allows Claude and other MCP clients to list and manage cloud storage buckets, upload and download files, apply intelligent image transformations, manage CDN cache, and control live broadcast streams — all through natural language. Developers and operations teams using Qiniu Cloud infrastructure can automate common cloud tasks directly from their AI assistant without switching to a separate console.
Prerequisites
- Python 3.10+ and uv package manager (install uv: pip install uv or via the official uv installer)
- Qiniu Cloud account with access key and secret key (QINIU_ACCESS_KEY and QINIU_SECRET_KEY)
- Target Qiniu storage bucket names and the bucket region name (QINIU_REGION_NAME)
- An MCP-compatible client such as Claude Desktop or Cursor
Clone the Qiniu MCP Server repository
Clone the official repository from GitHub and navigate into the project directory.
git clone https://github.com/qiniu/qiniu-mcp-server.git
cd qiniu-mcp-serverSet up the Python virtual environment and install dependencies
Use uv to create an isolated virtual environment and install the package in editable mode.
uv venv
source .venv/bin/activate
uv pip install -e .Gather your Qiniu credentials and bucket details
Log into the Qiniu Cloud console (https://portal.qiniu.com) to obtain your Access Key, Secret Key, bucket region (e.g., cn-east-1), and the names of buckets you want to expose. For live streaming, also note your live API key.
Add the server to your MCP client configuration
Edit your claude_desktop_config.json to add a Qiniu MCP server entry, setting all required environment variables with your credentials.
Restart your MCP client and test access
Restart Claude Desktop. Ask Claude to list your Qiniu buckets to verify the connection is working. You can also test with the MCP Inspector tool using the command below.
npx @modelcontextprotocol/inspector uv --directory /path/to/qiniu-mcp-server run qiniu-mcp-serverQiniu MCP Examples
Client configuration
Add this block to your claude_desktop_config.json. Fill in all environment variables with your actual Qiniu credentials and configuration.
{
"mcpServers": {
"qiniu": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/qiniu-mcp-server", "run", "qiniu-mcp-server"],
"env": {
"QINIU_ACCESS_KEY": "your_access_key",
"QINIU_SECRET_KEY": "your_secret_key",
"QINIU_REGION_NAME": "cn-east-1",
"QINIU_ENDPOINT_URL": "https://s3.cn-east-1.qiniucs.com",
"QINIU_BUCKETS": "my-bucket-1,my-bucket-2"
}
}
}
}Prompts to try
Use Claude to manage your Qiniu Cloud resources with these example prompts.
- "List all my Qiniu storage buckets."
- "Show me the files in my 'my-bucket-1' bucket."
- "Apply 200-pixel rounded corners to the image at key 'logo.png' in bucket 'assets'."
- "Refresh this CDN link: https://cdn.example.com/static/app.js"
- "Create a live broadcast space named 'stream-test-01'."
- "Get the push and pull addresses for stream 'main' in space 'stream-test-01'."Troubleshooting Qiniu MCP
Authentication fails with AccessDenied or invalid credentials error
Verify that QINIU_ACCESS_KEY and QINIU_SECRET_KEY are correct and that the key pair has the necessary permissions (Storage Read/Write, CDN, Live) in Qiniu console. Check for accidental whitespace in the credential strings.
Bucket not found or empty file listing even though files exist
Ensure the bucket name is included in the QINIU_BUCKETS environment variable (comma-separated list). Also verify QINIU_REGION_NAME matches the actual region of your bucket — mismatched regions cause empty results.
Live streaming tools fail or return permission errors
Live streaming operations may require a separate live API key. Set the QINIU_LIVE_API_KEY environment variable in your configuration with the key from the Qiniu Live console if the standard credentials do not have live streaming permissions.
Frequently Asked Questions about Qiniu MCP
What is Qiniu MCP?
Qiniu MCP is a Model Context Protocol (MCP) server that model context protocol (mcp) server built on qiniu cloud products supports users in accessing qiniu cloud storage, intelligent multimedia services, and more through this mcp server within the context of ai large model clients. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Qiniu MCP?
Follow the installation instructions on the Qiniu MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Qiniu MCP?
Qiniu MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Qiniu MCP free to use?
Yes, Qiniu MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Qiniu MCP Alternatives — Similar Cloud Services Servers
Looking for alternatives to Qiniu MCP? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Qiniu MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Qiniu MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.