@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