Wcs MCP Server

🚀 網宿 MCP 服務器

基於網宿雲產品構建的模型上下文協議（Model Context Protocol，簡稱 MCP）服務器，支持用戶在 AI 大模型客戶端的上下文中，通過該 MCP 服務器訪問網宿雲存儲、智能多媒體服務等。

🚀 快速開始

安裝

前置要求

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

如果尚未安裝 uv，可以使用以下命令進行安裝：

curl -LsSf https://astral.sh/uv/install.sh | sh

1. 克隆倉庫：

# 克隆項目並進入目錄
git clone git@github.com:Wangsu-Cloud-Storage/wcs-mcp-server.git
cd wcs-mcp-server

2. 創建並激活虛擬環境：

uv venv
source .venv/bin/activate  # 在 Linux/macOS 系統中
# 或者在 Windows 系統中
.venv\Scripts\activate

3. 安裝依賴：

uv pip install -e .

配置

1. 複製環境變量模板文件：

cp .env.example .env

2. 編輯 .env 文件，配置以下參數：

# S3/Kodo 認證信息
WOS_ACCESS_KEY=your_access_key  # 替換為你的訪問密鑰
WOS_SECRET_KEY=your_secret_key  # 替換為你的秘密密鑰

# 區域信息
WOS_REGION_NAME=your_region      # 替換為你所在的區域名稱
WOS_ENDPOINT_URL=endpoint_url    # 示例：https://s3.your_region.woscs.com

# 配置 bucket，多個 bucket 使用逗號分隔，建議最多配置 20 個 bucket
WOS_BUCKETS=bucket1,bucket2,bucket3  # 替換為你需要配置的 bucket 名稱

使用方法

啟動服務器

1. 使用標準輸入輸出（stdio）模式啟動（默認模式）：

uv --directory . run wos-mcp-server

2. 使用 SSE 模式啟動（適合流媒體場景）：

uv --directory . run --transport sse wos-mcp-server

✨ 主要特性

• 基於網宿雲產品構建，支持用戶在 AI 大模型客戶端上下文中，通過 MCP 服務器訪問網宿雲存儲、智能多媒體服務等。

📦 安裝指南

前置要求

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

若未安裝 uv，可使用以下命令安裝：

curl -LsSf https://astral.sh/uv/install.sh | sh

安裝步驟

1. 克隆倉庫：

# 克隆項目並進入目錄
git clone git@github.com:Wangsu-Cloud-Storage/wcs-mcp-server.git
cd wcs-mcp-server

2. 創建並激活虛擬環境：

uv venv
source .venv/bin/activate  # 在 Linux/macOS 系統中
# 或者在 Windows 系統中
.venv\Scripts\activate

3. 安裝依賴：

uv pip install -e .

💻 使用示例

啟動服務器

標準輸入輸出（stdio）模式（默認）

uv --directory . run wos-mcp-server

SSE 模式（適合流媒體場景）

uv --directory . run --transport sse wos-mcp-server

📚 詳細文檔

開發

項目目錄結構

wos-mcp-server/
├── src/
│   ├── main.py         # 主程序入口
│   └── resources/      # 資源文件目錄
└── uv_lock.yaml        # uv 包管理器的依賴鎖定文件

擴展功能

• 新增資源類型：在 src/resources 目錄下創建新的資源模塊，並在 main.py 中註冊該資源。
• 修改現有功能：根據需求對現有代碼進行調整，確保與網宿雲服務協議兼容。

測試

使用 Inspector 工具測試 MCP 服務器功能

• 列舉所有資源信息
• 列舉所有可用的 Bucket
• 列舉指定 Bucket 中的所有文件
• 讀取指定 Bucket 中特定文件的內容

使用 Cline 插件測試

• 在 Cline 中創建一個新的聊天窗口
• 連接 wos MCP Server
• 發送以下指令：
  • 列出所有資源信息
  • 列出所有可用的 Bucket
  • 列出指定 Bucket 中的所有文件
  • 讀取指定 Bucket 中特定文件的內容

通過以上步驟，您可以順利完成網宿 MCP 服務器的安裝、配置和使用。