Overview
What is wos MCP Server?
The wos MCP Server is a Model Context Protocol (MCP) server built on WCS (Wangsu Cloud Storage) cloud products. It allows users to access WCS cloud storage and intelligent multimedia services through AI large model clients.
How to use wos MCP Server?
Clone the repository, create a virtual environment with uv, install dependencies, then configure credentials in a .env file (access key, secret key, region, endpoint, and buckets). Start the server using uv --directory . run wos-mcp-server in stdio mode, or add --transport sse --port 8000 for SSE mode. Integrate with MCP-compatible clients like Cline.
Key features of wos MCP Server
- Supports both stdio and SSE transport modes.
- Configurable via environment variables or
.envfile. - S3/Kodo compatible for cloud storage operations.
- Integrates with AI model clients via MCP protocol.
- Extensible architecture for adding new business tools.
Use cases of wos MCP Server
- List all buckets or files within a bucket via AI chat.
- Read file contents from a specified bucket.
- Manage cloud storage resources interactively through an AI assistant.
- Enable AI agents to perform multimedia service operations on WCS.
FAQ from wos MCP Server
What are the prerequisites for running wos MCP Server?
Python 3.12 or higher and the uv package manager are required.
How do I configure authentication?
Set WOS_ACCESS_KEY, WOS_SECRET_KEY, WOS_REGION_NAME, WOS_ENDPOINT_URL, and WOS_BUCKETS in a .env file or as environment variables.
Which transport modes are supported?
Standard input/output (stdio) is the default mode; SSE mode can be enabled with --transport sse --port 8000 for web applications.
Can I limit the number of buckets?
Yes. Use WOS_BUCKETS with a comma-separated list. It is recommended to configure at most 20 buckets.
How can I test the server?
Use the Model Control Protocol Inspector tool: npx @modelcontextprotocol/inspector uv --directory . run wos-mcp-server. Also, the README provides steps for testing with the Cline VS Code extension.
