# 七牛云

对象存储读写、图片处理、CDN 刷新预取与直播管理。

- 类型：MCP
- 权限：可执行操作
- 门槛：需授权账号、需 API Key
- 官方入口：https://github.com/qiniu/qiniu-mcp-server
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/qiniu/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

需 Python 3.12+、uv，以及目标七牛资源的 AK/SK、地域、S3 Endpoint 和 Bucket；存储和流量费用按账号确认。

## 接入步骤

1. 准备自己已授权的存储桶、地域与 S3 Endpoint。 [官方入口](https://github.com/qiniu/qiniu-mcp-server)
2. 把凭据在本地填入下方环境变量，按官方客户端示例启动 MCP。 [官方入口](https://github.com/qiniu/qiniu-mcp-server)

## 验证方法

只读列出获授权存储桶或文件，核对资源所属账号与地域。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://developer.qiniu.com/kodo/12914/mcp-aimodel-kodo)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "qiniu": {
      "command": "uvx",
      "args": [
        "qiniu-mcp-server"
      ],
      "env": {
        "QINIU_ACCESS_KEY": "${QINIU_ACCESS_KEY}",
        "QINIU_SECRET_KEY": "${QINIU_SECRET_KEY}",
        "QINIU_REGION_NAME": "${QINIU_REGION_NAME}",
        "QINIU_ENDPOINT_URL": "${QINIU_ENDPOINT_URL}",
        "QINIU_BUCKETS": "${QINIU_BUCKETS}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'QINIU_ACCESS_KEY=${QINIU_ACCESS_KEY}' --env 'QINIU_SECRET_KEY=${QINIU_SECRET_KEY}' --env 'QINIU_REGION_NAME=${QINIU_REGION_NAME}' --env 'QINIU_ENDPOINT_URL=${QINIU_ENDPOINT_URL}' --env 'QINIU_BUCKETS=${QINIU_BUCKETS}' --transport stdio 'qiniu' -- 'uvx' 'qiniu-mcp-server'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.qiniu]
command = "uvx"
args = ["qiniu-mcp-server"]
env_vars = ["QINIU_ACCESS_KEY","QINIU_SECRET_KEY","QINIU_REGION_NAME","QINIU_ENDPOINT_URL","QINIU_BUCKETS"]
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://developer.qiniu.com/kodo/12914/mcp-aimodel-kodo)。七牛官方开发文档发布 MCP 用法并链接官方 qiniu/qiniu-mcp-server 仓库。

官方原文摘录（2026-11-05，来自上述依据）：

```
npx @modelcontextprotocol/inspector uvx qiniu-mcp-server
```

- [厂商官方接入文档](https://github.com/qiniu/qiniu-mcp-server)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)