Qiniu MCP Server

一个基于 MCP (Model Control Protocol) 的 S3 资源服务器，支持访问和管理七牛云 Kodo 存储服务。

功能特性

• 支持列举存储桶（Buckets）
• 支持列举对象（Objects）
• 支持读取对象内容
• 支持文本和图片等多种类型的内容展示
• 支持配置指定的存储桶访问
• 支持并发处理多个存储桶

前置要求

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

如果还没有安装 uv，可以使用以下命令安装：

安装

1. 克隆仓库：

2. 创建并激活虚拟环境：

3. 安装依赖：

配置

1. 复制环境变量模板：

2. 编辑 .env 文件，配置以下参数：

使用方法

启动服务器

1. 使用标准输入输出（stdio）模式启动（默认）：

2. 使用 SSE 模式启动（用于 Web 应用）：

可用工具

服务器提供以下工具：

1. ListBuckets
   • 列举所有可用的存储桶
   • 参数：
     • prefix：（可选）存储桶名称前缀
     • max_buckets：（可选）返回的最大存储桶数量
2. ListObjectsV2
   • 列举存储桶中的对象
   • 参数：
     • bucket：（必需）存储桶名称
     • prefix：（可选）对象键前缀
     • max_keys：（可选）返回的最大对象数量
3. GetObject
   • 获取对象内容
   • 参数：
     • bucket：（必需）存储桶名称
     • key：（必需）对象键名

支持的文件类型

服务器支持以下文件类型的处理：

1. 文本文件
2. 图片文件
   • 所有标准图片格式（image/*）

测试

强烈推荐使用 Model Control Protocol Inspector 进行测试。