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 配置，确保域名和证书正确配置。