cloud-infrastructurefile-systems

@zhigang1992/uploadfile-mcp▌

by zhigang1992

Upload local files to S3-compatible storage and get shareable public S3 URLs. Auto-organized into UUID folders to avoid

An MCP server that enables users to upload local files to S3-compatible storage and retrieve shareable public URLs. Files are automatically organized into unique UUID-based folders to prevent naming conflicts while preserving original filenames.

github stars

★ 0

GitHub npm

Automatic UUID folder organizationWorks with any S3-compatible storage

best for

/ Developers needing file hosting for applications
/ Sharing files with public access URLs
/ Building file upload workflows

capabilities

/ Upload files to S3-compatible storage
/ Generate shareable public URLs for uploaded files
/ Organize files into UUID-based folders
/ Preserve original filenames during upload

what it does

Upload local files to S3-compatible storage and get back shareable public URLs. Files are automatically organized into UUID folders to avoid naming conflicts.

about

@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.

how to install

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.

license

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.

readme

@zhigang1992/uploadfile-mcp

An MCP (Model Context Protocol) server that allows you to upload local files to S3-compatible storage and get shareable URLs.

Installation

Global installation

npm install -g @zhigang1992/uploadfile-mcp

Local installation

npm install @zhigang1992/uploadfile-mcp

Usage

Running directly with npx

npx @zhigang1992/uploadfile-mcp

Adding to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "upload-file": {
      "command": "npx",
      "args": ["@zhigang1992/uploadfile-mcp"]
    }
  }
}

Available Tools

`upload_file`

Upload 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 upload

Example 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.

Development

To install dependencies:

bun install

To run in development:

bun run dev

To build for distribution:

bun run build

Configuration

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.

License

MIT