MCP Directory

How to add Qiniu MCP Server to Cursor

Access Qiniu Cloud storage, smart multimedia, CDN, and live streaming from your AI client. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Qiniu MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Qiniu MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Qiniu MCP Server config there under the "mcpServers" key and restart the client.

Is Qiniu MCP Server safe to use with Cursor?

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