putput-mcp

@putput/mcp

为 AI Agent 提供文件上传功能。通过 Claude Code、Cursor、Windsurf 和 VS Code Copilot 上传、列出和管理文件，无需注册。

快速开始

获取免费 API 令牌（无需注册）：

curl -X POST https://putput.io/api/v1/auth/guest | jq .token

Claude Code

claude mcp add putput -- npx @putput/mcp -e PUTPUT_TOKEN=pp_your_token

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

VS Code Copilot

添加到 .vscode/mcp.json：

{
  "servers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

远程（Streamable HTTP）

如果你的客户端支持远程 MCP 服务：

https://putput.io/api/v1/mcp

在 Authorization 标头中将令牌作为 Bearer 令牌传递。

工具

工具	描述
upload_file	将 URL 中的文件上传到 PutPut，并获取 CDN 链接
list_files	列出已上传的文件，支持可选的前缀筛选和分页
delete_file	按 ID 删除文件
get_file_info	获取文件详情、统计信息和下载 URL

工作原理

1. AI Agent 使用 URL 调用 upload_file
2. PutPut 将文件上传到 Cloudflare R2
3. 获取 CDN URL，即可完成

无需 AWS，无需配置，无需部署。文件通过 300 多个边缘节点提供，出口流量费用为 $0。

定价

• 访客： 免费 1 GB，无需注册，保留 14 天
• 免费版： 免费 10 GB，需注册账号
• 专业版： 每月 $9 起，可用 50 GB，无限带宽，出口流量费用为 $0

链接

• 网站： https://putput.io
• API 文档： https://docs.putput.io
• SDK： npm install @putput/sdk
• CLI： npx @putput/cli upload <file>
• GitHub： https://github.com/putput-io