R2 Upload MCP Server

R2上传MCP服务器

用于将文件上传到Cloudflare R2存储的模型上下文协议（MCP）服务器。

特性

• 通过自动MIME类型检测将文件上传到R2 bucket
• 支持自定义对象键和内容类型
• 返回上传文件的公共URL
• 环境变量配置

安装

cd apps/r2-upload
pnpm install
pnpm build

配置

服务器根据环境变量自动配置自己。设置以下所需的环境变量：

所需的环境变量

• R2_ACCOUNT_ID：您的Cloudflare帐户ID
• R2_ACCESS_KEY_ID：R2 API访问密钥ID
• R2_SECRET_ACCESS_KEY：R2 API秘密访问密钥
• R2_BUCKET_NAME：R2桶的名称

可选环境变量

• R2_ENDPOINT：自定义端点URL（默认为 https://{accountId}.r2.cloudflarestorage.com)
• R2_CUSTOM_DOMAIN：公共文件URL的自定义域（默认为R2开发域）

获取R2凭据

1. 登录Cloudflare仪表板
2. 转到R2对象存储
3. 如果你还没有创建R2 bucket
4. 转到“管理R2 API令牌”
5. 为您的存储桶创建具有读/写权限的新API令牌
6. 记下访问密钥ID和秘密访问密钥

工具

上传文件

将文件上传到配置的R2 bucket。

参数：

• filePath （必填）：要上传的本地文件路径
• key （可选）：存储桶中的对象键/名称（默认为文件名）
• contentType （可选）：文件的MIME类型（如果未提供，则自动检测）

用法示例

配置环境变量后，您可以直接上传文件：

{
  "filePath": "/path/to/your/file.jpg",
  "key": "uploads/my-image.jpg"
}

支持的文件类型

服务器会自动检测常见文件扩展名的MIME类型：

• 图片：.jpg、.jpeg、.png、.gif、.webp
• 文档：.pdf、.txt、.json、.html、.css
• 脚本：.js
• 视频：.mp4、.mov、.avi
• 音频：.mp3、.wav

对于其他文件类型，默认为 application/octet-stream 或者您可以指定一个自定义 contentType.

MCP配置

将此添加到您的 mcp.json 配置文件：

{
  "mcpServers": {
    "r2-upload": {
      "command": "node",
      "args": ["./apps/r2-upload/dist/index.js"],
      "env": {
        "R2_ACCOUNT_ID": "your-cloudflare-account-id",
        "R2_ACCESS_KEY_ID": "your-r2-access-key-id", 
        "R2_SECRET_ACCESS_KEY": "your-r2-secret-access-key",
        "R2_BUCKET_NAME": "your-bucket-name",
        "R2_ENDPOINT": "https://your-account-id.r2.cloudflarestorage.com",
        "R2_CUSTOM_DOMAIN": "files.yourdomain.com"
      }
    }
  }
}

环境变量

通过在MCP配置中设置这些环境变量来配置服务器。如果设置了所有必需的环境变量，服务器将立即准备好上传文件。

自定义域设置

如果您为R2 bucket配置了自定义域（例如。， files.yourdomain.com)，设置 R2_CUSTOM_DOMAIN 环境变量。服务器将使用您的自定义域而不是默认的R2开发域返回公共URL。

运行服务器

# Build first
pnpm build

# Run standalone
pnpm start

该服务器作为stdio MCP服务器运行，并通过stdin/stdout进行通信。