io.github.putput-io-dev/putput-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http putput-mcp 'https://putput.io/api/v1/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "putput-mcp": {
            "type": "http",
            "url": "https://putput.io/api/v1/mcp"
        }
    }
}
NPM package @putput/mcp
Claude Code
claude mcp add putput-mcp -e 'PUTPUT_TOKEN=<your putput_token>' -- npx -y @putput/mcp@0.0.3
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "putput-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@putput/mcp@0.0.3"
            ],
            "env": {
                "PUTPUT_TOKEN": "<your putput_token>"
            }
        }
    }
}

متغيرات البيئة

  • PUTPUT_TOKEN إلزامي سري PutPut API token. Get one free without signup: curl -X POST https://putput.io/api/v1/auth/guest | jq .token

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @putput/mcp
  2. Quick Start
  3. Tools
  4. How It Works
  5. Pricing
  6. Links

@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):

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

Add to .cursor/mcp.json:

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

Add to .vscode/mcp.json:

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

Add to ~/.codeium/windsurf/mcp_config.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

الأسئلة الشائعة

ما هو io.github.putput-io-dev/putput-mcp؟

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

كيف أثبّت io.github.putput-io-dev/putput-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http putput-mcp 'https://putput.io/api/v1/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.putput-io-dev/putput-mcp إلى مفتاح API؟

نعم. يتطلب PUTPUT_TOKEN، وتضبطها في إعداداته.

هل io.github.putput-io-dev/putput-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.putput-io-dev/putput-mcp؟

ينشره putput-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.