MCP Directory

How to add Qiniu MCP Server to Windsurf

Access Qiniu Cloud storage, smart multimedia, CDN, and live streaming from your AI client. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Qiniu MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Qiniu MCP Server's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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