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 分

    請在儲存庫或註冊中心條目中宣告授權條款。