Putput Mcp

io.github.putput-io-dev由 GitHub 账号 putput-io-dev 发布v0.0.3更新于 Oct 24, 2026

File uploads for AI agents. Upload, list, and manage files. No signup required.

已验证Streamable HTTP可网页运行云端与基础设施文件与存储

概览

AI 生成的概览

PutPut MCP 让 AI 助手把 URL 指向的文件上传到 PutPut 存储，并可列出、查看或删除文件，返回 CDN 链接。

可以做什么
从 URL 上传文件到 PutPut 存储并返回 CDN 链接，文件存放在 Cloudflare R2 并由边缘节点提供访问。按前缀筛选和分页列出已上传的文件。查看指定文件的详情、统计信息和下载链接。按 ID 删除已上传的文件。
适用场景
当助手需要发布一个已有 URL 的文件并返回可分享的 CDN 链接时适用，也适合在不自行搭建云存储的情况下浏览和清理此前上传的文件。
运行要求
需要 PutPut API 令牌，放在 PUTPUT_TOKEN 环境变量中；使用远程端点时则作为 Authorization 头中的 Bearer 令牌。本地包通过 npx 运行，需要 Node.js。访客令牌无需注册即可获取，更大套餐需要账号。需要能访问 PutPut 的网络。
安装前请注意
PUTPUT_TOKEN 是密钥，应避免写入共享配置和日志。上传会把所引用的文件发送给 PutPut 和第三方 Cloudflare R2。删除操作会永久移除文件。访客存储上限为 1 GB 且 14 天后过期，付费套餐每月 9 美元起。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Putput Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.putput-io-dev%2Fputput-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "putput": {
      "type": "http",
      "url": "https://putput.io/api/v1/mcp"
    }
  }
}

README

@putput/mcp

File uploads for AI agents. Upload, list, and manage files from Claude Code, Cursor, Windsurf, and VS Code Copilot — no signup required.

Quick Start

Get a free API token (no signup):

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

Claude Code

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

Cursor

Add to .cursor/mcp.json:

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

VS Code Copilot

Add to .vscode/mcp.json:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Remote (Streamable HTTP)

If your client supports remote MCP servers:

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

Pass your token as a Bearer token in the Authorization header.

Tools

ToolDescription
upload_fileUpload a file from a URL to PutPut and get a CDN link back
list_filesList uploaded files with optional prefix filter and pagination
delete_fileDelete a file by ID
get_file_infoGet file details, stats, and download URL

How It Works

  1. Your AI agent calls upload_file with a URL
  2. PutPut uploads the file to Cloudflare R2
  3. You get back a CDN URL — done

No AWS, no config, no deploy step. Files are served from 300+ edge locations with $0 egress.

Pricing

  • Guest: 1 GB free, no signup, 14-day expiry
  • Free: 10 GB free, requires account
  • Pro: From $9/mo for 50 GB, unlimited bandwidth, $0 egress

Links

来源：README.md，提交 1cb032a

工具

4

upload_file

Upload a file from a URL to PutPut storage

输入参数url必填prefixfilenamemetadatavisibility

list_files

List uploaded files with optional filtering

输入参数limitcursorprefix

delete_file

Delete an uploaded file by ID

输入参数id必填

get_file_info

Get details about a specific file

输入参数id必填

版本历史

1
  1. v0.0.3最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。