Overview
The Model Context Protocol (MCP) Server built on Sufy products allows users to access Sufy services through this MCP Server within the context of AI large model clients.
Environment Requirements
- Python 3.12 or higher
- uv package manager
If you haven't installed uv yet, you can install it with the following command:
Here's the English translation of the provided text:
# Mac, recommended to install using brew
brew install uv
# Linux & Mac
# 1. Installation
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. After installation, make sure to add the package installation directory (the directory containing uv and uvx executables) to your system's PATH environment variable.
# Assuming the installation path is /Users/xxx/.local/bin (see installation output)
### Temporary effect (current session), execute the following command in your current terminal:
export PATH="/Users/xxx/.local/bin:$PATH"
### Permanent effect (recommended), execute the following command in your current terminal:
echo 'export PATH="/Users/xxx/.local/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
For specific installation methods, refer to uv installation.
Usage in Cline
Steps:
- Install the Cline plugin in VSCode (the Cline icon will appear in the sidebar after installation)
- Configure the Large Model
- Configure Sufy MCP
- Click the Cline icon to enter the plugin interface and select the MCP Server module
- Choose "Installed", click "Advanced MCP Settings", and configure using the following template:
{ "mcpServers": { "Sufy": { "command": "uvx", "args": [ "sufy-mcp-server" ], "env": { "SUFY_ACCESS_KEY": "YOUR_ACCESS_KEY", "SUFY_SECRET_KEY": "YOUR_SECRET_KEY", "SUFY_REGION_NAME": "YOUR_REGION_NAME", "SUFY_ENDPOINT_URL": "YOUR_ENDPOINT_URL", "SUFY_BUCKETS": "YOUR_BUCKET_A,YOUR_BUCKET_B" }, "disabled": false } } }- Toggle the connection switch for Sufy MCP Server to establish connection
- Create a chat window in Cline to interact with AI using sufy-mcp-server. Example prompts:
- List Sufy resource information
- List all Buckets in Sufy
- List files in Sufy's xxx Bucket
- Read content of yyy file in Sufy's xxx Bucket
- Resize image yyy in Sufy's xxx Bucket by 20%
Note: When creating an MCP Server in Cline, you can directly use the above configuration.