Skip to main content
Glama
zhigang1992

@zhigang1992/uploadfile-mcp

by zhigang1992

@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

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhigang1992/upload-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server