Qiniu MCP Server 1nk

🚀 七牛雲 MCP 服務器

基於七牛雲產品構建的 Model Context Protocol (MCP) 服務器，能讓用戶在 AI 大模型客戶端的上下文中與七牛雲服務交互。該服務器支持七牛雲存儲（Kodo）、智能多媒體處理和內容分發網絡（CDN）等功能。

🚀 快速開始

基於七牛雲產品構建的 Model Context Protocol (MCP) 服務器，支持用戶在 AI 大模型客戶端的上下文中與七牛雲服務進行交互。若要使用該服務器，需先完成安裝與配置。

✨ 主要特性

• 存儲：支持文件上傳、下載、刪除和列舉操作。
• 智能多媒體：提供圖片縮放、格式轉換、水印添加等功能。
• CDN：實現靜態資源的高效分發，提升內容交付速度。

📦 安裝指南

環境要求

軟件環境

• Python版本：建議使用 Python 3.8 或更高版本。
• uv 包管理器：用於統一管理和運行服務，默認已包含在項目中。

操作系統

• 支持Linux（推薦）和macOS，Windows平臺需額外配置。

安裝依賴

1. 克隆代碼倉庫：

   git clone https://github.com/qiniu/mcp-server.git
   cd mcp-server
   

2. 安裝項目依賴：

   uv pip install -e .
   

3. 配置環境變量： 複製並修改 env.example 文件，填寫真實的七牛雲憑證和區域信息。

運行服務

快速啟動

1. 在項目根目錄下運行：

   uv --directory . run qiniu-mcp-server
   

2. 啟用調試模式：

   uv --directory . run qiniu-mcp-server --debug
   

💻 使用示例

基礎用法

上傳文件到存儲桶

import qiniu

# 初始化七牛雲配置
config = qiniu.Config(
    access_key='your_access_key',
    secret_key='your_secret_key',
    region=Region.region_z0()
)

# 創建存儲實例
bucket = qiniu.Bucket(config, 'your_bucket_name')

# 上傳文件
with open('file.jpg', 'rb') as f:
    res = bucket.put_stream('target.jpg', f)

處理多媒體資源

from qiniuImagePathProcessor import ImageProcessor

processor = ImageProcessor(access_key='...', secret_key='...')
processed_image = processor.resize('original.jpg', width=800, height=600)

📚 詳細文檔

擴展開發

新增功能模塊

在 core/storage 目錄下創建新業務包，按需添加工具類和資源擴展文件。

註冊自定義工具

在業務包的 __init__.py 中定義加載函數，並在 core/__init__.py 中統一註冊。

測試方法

使用 Inspector 工具測試

1. 安裝並運行 Inspector：

   npm install -g @modelcontextprotocol/inspector
   inspector run qiniu-mcp-server
   

2. 驗證接口響應，確保所有操作符合預期。

常見問題

1. 如何處理上傳失敗？

   • 檢查網絡連接和七牛雲憑證配置。

2. 多媒體處理慢怎麼辦？

   • 確保七牛雲賬號有足夠的處理配額。

3. CDN加速效果不明顯？

   • 檢查 CDN 配置，確保域名和證書正確配置。