Qiniu MCP Server

基本能力

产品定位

Qiniu MCP Server 是一个基于七牛云产品的 MCP 服务，旨在为大模型客户端提供访问七牛云存储和智能多媒体服务的能力。

核心功能

1. 七牛云存储访问：支持通过 MCP 协议访问七牛云存储，包括列举 bucket、读取文件内容等操作。
2. 智能多媒体服务：支持访问七牛云的智能多媒体服务。
3. 多模式启动：支持标准输入输出（stdio）模式和 SSE 模式（用于 Web 应用）。
4. 扩展性：支持通过新增业务目录和 loader.py 文件来扩展功能。

适用场景

1. 大模型客户端：需要访问七牛云存储或智能多媒体服务的大模型客户端。
2. Web 应用：需要通过 SSE 模式与 MCP Server 交互的 Web 应用。
3. 开发与测试：开发者可以通过 MCP Server 进行功能扩展和测试。

工具列表

1. Model Control Protocol Inspector：用于测试 MCP Server 的工具。
2. cline 插件：用于在 VSCode 中配置和测试 MCP Server 的插件。

常见问题解答

1. 如何配置七牛云存储的认证信息？：通过编辑 .env 文件配置 QINIU_ACCESS_KEY、QINIU_SECRET_KEY 等参数。
2. 如何启动 SSE 模式？：使用命令 uv --directory . run qiniu-mcp-server --transport sse --port 8000。
3. 如何扩展功能？：在 core 目录下新增业务目录，并在 loader.py 中定义 load 函数。

使用教程

使用依赖

1. Python 3.12 或更高版本：确保系统已安装 Python 3.12 或更高版本。
2. uv 包管理器：安装 uv 包管理器，命令如下： bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 克隆仓库： bash git clone [email protected]:qiniu/qiniu-mcp-server.git cd qiniu-mcp-server
2. 创建并激活虚拟环境： bash uv venv source .venv/bin/activate # Linux/macOS # 或 .venv\Scripts\activate # Windows
3. 安装依赖： bash uv pip install -e .

配置

1. 复制环境变量模板： bash cp .env.example .env
2. 编辑 .env 文件：配置七牛云存储的认证信息、区域信息和 bucket。

调试方式

1. 启动服务器：
2. 标准输入输出模式： bash uv --directory . run qiniu-mcp-server
3. SSE 模式： bash uv --directory . run qiniu-mcp-server --transport sse --port 8000
4. 测试：
5. 使用 Model Control Protocol Inspector 测试： shell npx @modelcontextprotocol/inspector uv --directory . run qiniu-mcp-server
6. 使用 cline 插件测试：配置 cline 插件并连接 MCP Server 进行交互。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。