Skip to content
MCP server

Aliyun OSS MCP Server

Aliyun OSS file tools for MCP: upload, replace, download, zip, delete, signed URLs.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
today

About Aliyun OSS MCP Server

Aliyun OSS MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add oss-mcp-server --env OSS_ACCESS_KEY_ID='<OSS_ACCESS_KEY_ID>' --env OSS_ACCESS_KEY_SECRET='<OSS_ACCESS_KEY_SECRET>' --env OSS_ENDPOINT='<OSS_ENDPOINT>' --env OSS_BUCKET='<OSS_BUCKET>' --env OSS_SECURITY_TOKEN='<OSS_SECURITY_TOKEN>' -- uvx oss-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "oss-mcp-server": {
      "command": "uvx",
      "args": [
        "oss-mcp-server"
      ],
      "env": {
        "OSS_ACCESS_KEY_ID": "<OSS_ACCESS_KEY_ID>",
        "OSS_ACCESS_KEY_SECRET": "<OSS_ACCESS_KEY_SECRET>",
        "OSS_ENDPOINT": "<OSS_ENDPOINT>",
        "OSS_BUCKET": "<OSS_BUCKET>",
        "OSS_SECURITY_TOKEN": "<OSS_SECURITY_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oss-mcp-server": {
      "command": "uvx",
      "args": [
        "oss-mcp-server"
      ],
      "env": {
        "OSS_ACCESS_KEY_ID": "<OSS_ACCESS_KEY_ID>",
        "OSS_ACCESS_KEY_SECRET": "<OSS_ACCESS_KEY_SECRET>",
        "OSS_ENDPOINT": "<OSS_ENDPOINT>",
        "OSS_BUCKET": "<OSS_BUCKET>",
        "OSS_SECURITY_TOKEN": "<OSS_SECURITY_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "oss-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oss-mcp-server"
      ],
      "env": {
        "OSS_ACCESS_KEY_ID": "<OSS_ACCESS_KEY_ID>",
        "OSS_ACCESS_KEY_SECRET": "<OSS_ACCESS_KEY_SECRET>",
        "OSS_ENDPOINT": "<OSS_ENDPOINT>",
        "OSS_BUCKET": "<OSS_BUCKET>",
        "OSS_SECURITY_TOKEN": "<OSS_SECURITY_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "oss-mcp-server": {
      "command": "uvx",
      "args": [
        "oss-mcp-server"
      ],
      "env": {
        "OSS_ACCESS_KEY_ID": "<OSS_ACCESS_KEY_ID>",
        "OSS_ACCESS_KEY_SECRET": "<OSS_ACCESS_KEY_SECRET>",
        "OSS_ENDPOINT": "<OSS_ENDPOINT>",
        "OSS_BUCKET": "<OSS_BUCKET>",
        "OSS_SECURITY_TOKEN": "<OSS_SECURITY_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "oss-mcp-server": {
      "command": "uvx",
      "args": [
        "oss-mcp-server"
      ],
      "env": {
        "OSS_ACCESS_KEY_ID": "<OSS_ACCESS_KEY_ID>",
        "OSS_ACCESS_KEY_SECRET": "<OSS_ACCESS_KEY_SECRET>",
        "OSS_ENDPOINT": "<OSS_ENDPOINT>",
        "OSS_BUCKET": "<OSS_BUCKET>",
        "OSS_SECURITY_TOKEN": "<OSS_SECURITY_TOKEN>"
      }
    }
  }
}

Configuration

  • OSS_ACCESS_KEY_IDAliyun AccessKey ID with access to the target OSS bucket.Required
  • OSS_ACCESS_KEY_SECRETAliyun AccessKey Secret paired with OSS_ACCESS_KEY_ID.Required
  • OSS_ENDPOINTOSS endpoint, for example oss-cn-hangzhou.aliyuncs.com.Required
  • OSS_BUCKETOSS bucket name.Required
  • OSS_SECURITY_TOKENOptional STS security token for temporary credentials.
  • OSS_DOMAINOptional custom domain used for public-read object URLs.
  • OSS_DEFAULT_PREFIXOptional default object key prefix added to relative paths.
  • OSS_PUBLIC_READWhether the bucket is public-read; true or false.

Pricing

Open source

Aliyun OSS MCP Server FAQ

Is Aliyun OSS MCP Server free?

Yes. Aliyun OSS MCP Server is open source, so you can use and self-host it for free.

How do I add Aliyun OSS MCP Server to Claude Code?

Run this command in your terminal: claude mcp add oss-mcp-server --env OSS_ACCESS_KEY_ID='<OSS_ACCESS_KEY_ID>' --env OSS_ACCESS_KEY_SECRET='<OSS_ACCESS_KEY_SECRET>' --env OSS_ENDPOINT='<OSS_ENDPOINT>' --env OSS_BUCKET='<OSS_BUCKET>' --env OSS_SECURITY_TOKEN='<OSS_SECURITY_TOKEN>' -- uvx oss-mcp-server