Qiniu MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

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 git@github.com: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 进行交互。