by zhigang1992
Upload local files to S3-compatible storage and get shareable public S3 URLs. Auto-organized into UUID folders to avoid
Upload local files to S3-compatible storage and get back shareable public URLs. Files are automatically organized into UUID folders to avoid naming conflicts.
@zhigang1992/uploadfile-mcp is a community-built MCP server published by zhigang1992 that provides AI assistants with tools and capabilities via the Model Context Protocol. Upload local files to S3-compatible storage and get shareable public S3 URLs. Auto-organized into UUID folders to avoid It is categorized under cloud infrastructure, file systems.
You can install @zhigang1992/uploadfile-mcp in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
@zhigang1992/uploadfile-mcp is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Read, analyze, and understand files in your project
Example
Summarize README, analyze code structure, find TODO comments across codebase
Navigate large codebases 5x faster, understand projects quickly
Create, move, rename, and organize files based on natural language instructions
Example
Organize downloads by file type, rename files following convention, batch process images
Save hours on manual file organization
Search files for patterns, extract data, find information across directories
Example
Find all config files with API keys, extract emails from documents, search logs for errors
Find information instantly instead of manual grep/find
Share your MCP server with the developer community
We evaluated @zhigang1992/uploadfile-mcp against two servers with overlapping tools; this profile had the clearer scope statement.
We evaluated @zhigang1992/uploadfile-mcp against two servers with overlapping tools; this profile had the clearer scope statement.
Useful MCP listing: @zhigang1992/uploadfile-mcp is the kind of server we cite when onboarding engineers to host + tool permissions.
We evaluated @zhigang1992/uploadfile-mcp against two servers with overlapping tools; this profile had the clearer scope statement.
Useful MCP listing: @zhigang1992/uploadfile-mcp is the kind of server we cite when onboarding engineers to host + tool permissions.
Useful MCP listing: @zhigang1992/uploadfile-mcp is the kind of server we cite when onboarding engineers to host + tool permissions.
@zhigang1992/uploadfile-mcp reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
@zhigang1992/uploadfile-mcp is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
I recommend @zhigang1992/uploadfile-mcp for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
@zhigang1992/uploadfile-mcp reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
showing 1-10 of 55
An MCP (Model Context Protocol) server that allows you to upload local files to S3-compatible storage and get shareable URLs.
npm install -g @zhigang1992/uploadfile-mcp
npm install @zhigang1992/uploadfile-mcp
npx @zhigang1992/uploadfile-mcp
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"upload-file": {
"command": "npx",
"args": ["@zhigang1992/uploadfile-mcp"]
}
}
}
upload_fileUpload a local file to S3-compatible storage and receive a shareable URL. Files are automatically organized in unique UUID folders to prevent naming conflicts.
Parameters:
file_path (required): Local path to the file to uploadExample usage:
{
"file_path": "/path/to/local/file.jpg"
}
Returns:
{
"success": true,
"file_path": "/path/to/local/file.jpg",
"folder_id": "e4847e59-2003-443c-bd47-775fc6b6a195",
"original_filename": "file.jpg",
"remote_path": "e4847e59-2003-443c-bd47-775fc6b6a195/file.jpg",
"url": "https://s3.reily.app/public/e4847e59-2003-443c-bd47-775fc6b6a195/file.jpg",
"message": "File uploaded successfully to https://s3.reily.app/public/e4847e59-2003-443c-bd47-775fc6b6a195/file.jpg"
}
Note: Each uploaded file is placed in a unique folder (UUID-based) to prevent naming conflicts while preserving the original filename.
To install dependencies:
bun install
To run in development:
bun run dev
To build for distribution:
bun run build
This MCP server uses the S3-compatible endpoint at https://s3.reily.app and uploads files to the public bucket. The uploaded files are publicly accessible.
MIT
Generate boilerplate files, apply templates, create project structures
Example
Create React component with tests and styles, generate OpenAPI spec, scaffold new project
Eliminate repetitive file creation work
Prerequisites
Time Estimate
10-20 minutes including configuration
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
MCP server provides file I/O operations (read, write, search, metadata) as tools Claude can invoke with natural language instructions.
Protocols
Compatibility
✓ Use when
Use for code analysis, file organization, content search, template generation, and automating repetitive file operations. Best for local development workflows.
✗ Avoid when
Avoid for system-critical files, sensitive credentials, production environments, or when file integrity is paramount. Don't use on files you can't afford to lose.