Sufy MCP Server

🚀 Sufy MCP 服務器

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 --