Object Storage Service:OSS MCP Server (Alpha)

Tool parameters

Example prompts

Once connected, use natural language to interact with your OSS data:

• "List all my OSS buckets"

• "Show me the storage stats for my-bucket"

• "What region is my-bucket in?"

• "How many objects are in my-bucket?"

• "List buckets in resource group rg-abc123"

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "alibabacloud-oss": {
      "command": "npx",
      "args": ["-y", "alibabacloud-oss-mcp-server@alpha"],
      "env": {
        "OSS_ACCESS_KEY_ID": "<your-access-key-id>",
        "OSS_ACCESS_KEY_SECRET": "<your-access-key-secret>"
      }
    }
  }
}

Cherry Studio

Configure a new MCP server with these settings:

Start the server

export OSS_ACCESS_KEY_ID="<your-access-key-id>"
export OSS_ACCESS_KEY_SECRET="<your-access-key-secret>"

npx -y -p alibabacloud-oss-mcp-server@alpha -p express alibabacloud-oss-mcp-server --transport=streamable-http --port=18081

The server listens at http://localhost:18081/mcp.

OSS MCP Server only listens on localhost. For remote access, set up a reverse proxy with port forwarding. Configure HTTPS and authentication on the reverse proxy before exposing it to external traffic.

Configure clients

Cherry Studio

Dify

Basic usage

import { OSSMcpServer, OSSMcpServerTransport } from 'alibabacloud-oss-mcp-server/server';

const server = new OSSMcpServer({
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  securityToken: process.env.OSS_SECURITY_TOKEN,  // Only for temporary credentials
  region: process.env.OSS_REGION,
  endpoint: process.env.OSS_ENDPOINT,
  transportType: OSSMcpServerTransport.STDIO
});

await server.runServer();

Configuration options