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»).
claude mcp add --transport http putput-mcp 'https://putput.io/api/v1/mcp'
{
"mcpServers": {
"putput-mcp": {
"type": "http",
"url": "https://putput.io/api/v1/mcp"
}
}
}
@putput/mcpclaude mcp add putput-mcp -e 'PUTPUT_TOKEN=<your putput_token>' -- npx -y @putput/mcp@0.0.3
{
"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.
@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
| Tool | Description |
|---|---|
upload_file | Upload a file from a URL to PutPut and get a CDN link back |
list_files | List uploaded files with optional prefix filter and pagination |
delete_file | Delete a file by ID |
get_file_info | Get file details, stats, and download URL |
How It Works
- Your AI agent calls
upload_filewith a URL - PutPut uploads the file to Cloudflare R2
- 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
- Website: https://putput.io
- API Docs: https://docs.putput.io
- SDK:
npm install @putput/sdk - CLI:
npx @putput/cli upload <file> - GitHub: https://github.com/putput-io
الأسئلة الشائعة
ما هو 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.