MCP Directory

How to add Qiniu MCP Server to Claude Desktop

Access Qiniu Cloud storage, smart multimedia, CDN, and live streaming from your AI client. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 37★ · stdio · apikey

Claude Desktop config for Qiniu MCP Server

uvx qiniu-mcp-server
{
  "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.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Qiniu MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Qiniu MCP Server's tools appear under the 🔌 tools menu.

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)

What Qiniu MCP Server can do in Claude Desktop

List buckets

Get the list of Qiniu storage buckets.

List files

Get the list of files in a bucket.

Upload file

Upload a local file, or upload provided file content.

Read file

Read the contents of a file.

Get download link

Get a download link for a file.

Resize image

Scale/resize an image via Qiniu intelligent multimedia.

Round image corners

Apply rounded corners to an image.

CDN refresh

Refresh a file on the CDN by its URL.

Security

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Qiniu MCP Server config there under the "mcpServers" key and restart the client.

Is Qiniu MCP Server safe to use with Claude Desktop?

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).

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'.

View repo Full Qiniu MCP Server page