Oss Mcp

What is Oss Mcp?

Oss Mcp is a Model Context Protocol (MCP) server that enables large language models to upload files directly to Alibaba Cloud Object Storage Service (OSS). It is built for developers and AI workflows that need to store files in the cloud via an MCP‑compatible interface.

How to use Oss Mcp?

Install globally with npm install -g oss-mcp or pnpm add -g oss-mcp. Configure one or more OSS accounts via the --oss-config command‑line argument, a .env file, or environment variables. Start the server using oss-mcp --oss-config='...' --stdio for stdio mode or oss-mcp --http -p 3000 for HTTP mode.

Key features of Oss Mcp

• Supports multiple Alibaba Cloud OSS configurations.
• Allows specifying an upload directory.
• Provides two tools: upload_to_oss and list_oss_configs.
• Integrates seamlessly with other MCP tools (Playwright, Figma, Filesystem).
• Runs over stdio or HTTP transport.
• Can be launched with an Inspector for debugging.

Use cases of Oss Mcp

• Upload webpage screenshots or resources captured by Playwright MCP directly to OSS.
• Upload files from Figma MCP or local file system to cloud storage.
• Automate data backup from local or other services to OSS.
• Process media (images, videos) and upload the results to obtain a shareable URL.
• Manage multiple OSS accounts and switch between them easily.

FAQ from Oss Mcp

What runtime dependencies does Oss Mcp require?

It requires Node.js and npm (or pnpm) installed globally. The server is distributed as an npm package (oss-mcp).

How can I configure multiple OSS accounts?

Define environment variables such as OSS_CONFIG_DEFAULT and OSS_CONFIG_TEST, each containing a JSON object with region, accessKeyId, accessKeySecret, bucket, and endpoint. Alternatively, pass a JSON object with multiple configs to the --oss-config argument.

Which transport modes are supported?

Oss Mcp supports both stdio mode (--stdio) and HTTP mode (--http, default port 3000). You can also launch the server with the Inspector for debugging using --inspect.

Where do uploaded files go?

Files are uploaded to the Alibaba Cloud OSS bucket specified in the active configuration. The tool upload_to_oss accepts a local file path and optional target directory and file name.

What authentication is used?

Authentication uses Alibaba Cloud access keys (accessKeyId and accessKeySecret). These are provided through environment variables, a .env file, or the --oss-config command‑line option.