Sufy MCP 服务器

中文文档 | 英文文档

概述

基于 Sufy 产品的 Model Context Protocol (MCP) 服务器允许用户通过 AI 大模型客户端的上下文访问 Sufy 服务。

环境要求

• Python 3.12 或更高版本
• uv 包管理器

如果你尚未安装 uv，请使用以下命令进行安装：

# Mac，推荐使用 brew 安装
brew install uv


# Linux & Mac
# 1. 安装
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. 安装完成后，确保将包安装目录（包含 uv 和 uvx 可执行文件的目录）添加到系统的 PATH 环境变量中。
# 假设计算机安装路径为 /Users/xxx/.local/bin（参考安装输出）
### 临时效果（当前会话），在当前终端执行以下命令：
export PATH="/Users/xxx/.local/bin:$PATH"
### 永久效果（推荐），在当前终端执行以下命令：
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"

具体安装方法请参考 uv 安装。

命令行界面中的使用

步骤：

1. 在 VSCode 中安装 Cline 插件（安装完成后，侧边栏会出现 Cline 图标）
2. 配置大模型
3. 配置 Sufy MCP
   1. 点击 Cline 图标进入插件界面，选择 MCP Server 模块
   2. 选择 "已安装"，点击 "高级 MCP 设置"，使用以下模板进行配置：

   {
     "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
       }
     }
   }
   

   3. 切换 Sufy MCP Server 的连接开关，建立连接
4. 在 Cline 中创建一个聊天窗口，使用 sufy-mcp-server 与 AI 进行交互。示例提示词： ◦ 列出 Sufy 资源信息 ◦ 列出 Sufy 中的所有存储桶 ◦ 列出 Sufy 的 xxx 存储桶中的文件 ◦ 阅读 Sufy 的 xxx 存储桶中 yyy 文件的内容 ◦ 将 Sufy 的 xxx 存储桶中的 yyy 图像按 20% 缩放

注意：在 Cline 中创建 MCP Server 时，可以直接使用上述配置。

开发

1. 克隆仓库：

git clone git@github.com:sufy/sufy-mcp-server.git
cd sufy-mcp-server

2. 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # Linux/macOS
# 或者
.venv\Scripts\activate  # Windows

3. 安装依赖项：

uv pip install -r requirements.txt

4. 运行服务器：

uv --directory . run sufy-mcp-server

测试

使用模型控制协议检查仪

推荐工具：模型控制协议检查仪

# 需要 Node.js v22.4.0
npx @modelcontextprotocol/inspector uv --directory . run sufy-mcp-server

本地 MCP 服务器示例

1. 在标准输入输出模式下运行（默认）：

uv --directory . run sufy-mcp-server

2. 在 SSE 模式下运行（适用于 Web 应用程序）：

uv --