金大哥 - qiniu-mcp-server-1nk MCP 详情

article

README

🚀 七牛云 MCP 服务器

基于七牛云产品构建的 Model Context Protocol (MCP) 服务器，能让用户在 AI 大模型客户端的上下文中与七牛云服务交互。该服务器支持七牛云存储（Kodo）、智能多媒体处理和内容分发网络（CDN）等功能。

🚀 快速开始

基于七牛云产品构建的 Model Context Protocol (MCP) 服务器，支持用户在 AI 大模型客户端的上下文中与七牛云服务进行交互。若要使用该服务器，需先完成安装与配置。

✨ 主要特性

存储：支持文件上传、下载、删除和列举操作。
智能多媒体：提供图片缩放、格式转换、水印添加等功能。
CDN：实现静态资源的高效分发，提升内容交付速度。

📦 安装指南

环境要求

软件环境

Python版本：建议使用 Python 3.8 或更高版本。
uv 包管理器：用于统一管理和运行服务，默认已包含在项目中。

操作系统

支持Linux（推荐）和macOS，Windows平台需额外配置。

安装依赖

克隆代码仓库：

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

安装项目依赖：
```
uv pip install -e .
```
配置环境变量：复制并修改 env.example 文件，填写真实的七牛云凭证和区域信息。

运行服务

快速启动

在项目根目录下运行：
```
uv --directory . run qiniu-mcp-server
```

启用调试模式：

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 工具测试

安装并运行 Inspector：

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

验证接口响应，确保所有操作符合预期。

常见问题

如何处理上传失败？
- 检查网络连接和七牛云凭证配置。
多媒体处理慢怎么办？
- 确保七牛云账号有足够的处理配额。
CDN加速效果不明显？
- 检查 CDN 配置，确保域名和证书正确配置。

qiniu-mcp-server-1nk