Skip to main content
Glama
@zhigang1992/uploadfile-mcp

@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

Related MCP server: S3-Compatible 3D Storage MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers