@zhigang1992/uploadfile-mcp

@zhigang1992/uploadfile-mcp

zhigang1992

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

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.

132 views1Local (stdio)

What it does

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

Best for

Developers needing file hosting for applicationsSharing files with public access URLsBuilding file upload workflows
Automatic UUID folder organizationWorks with any S3-compatible storage

About @zhigang1992/uploadfile-mcp

@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

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

@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

Alternatives

Related Skills

Browse all skills
email-systems

Email has the highest ROI of any marketing channel. $36 for every $1 spent. Yet most startups treat it as an afterthought - bulk blasts, no personalization, landing in spam folders. This skill covers transactional email that works, marketing automation that converts, deliverability that reaches inboxes, and the infrastructure decisions that scale. Use when: keywords, file_patterns, code_patterns.

4
hugging-face-cli

Execute Hugging Face Hub operations using the `hf` CLI. Use when the user needs to download models/datasets/spaces, upload files to Hub repositories, create repos, manage local cache, or run compute jobs on HF infrastructure. Covers authentication, file transfers, repository creation, cache operations, and cloud compute.

2
auditing-access-control

This skill enables Claude to audit access control implementations in various systems. It uses the access-control-auditor plugin to identify potential vulnerabilities and misconfigurations related to access control. Use this skill when the user asks to "audit access control", "check permissions", "assess access rights", or requests a "security review" focused on access management. It's particularly useful for analyzing IAM policies, ACLs, and other access control mechanisms in cloud environments, applications, or infrastructure. The skill helps ensure compliance with security best practices and identify potential privilege escalation paths.

1
terraform-specialist

Expert Terraform/OpenTofu specialist mastering advanced IaC automation, state management, and enterprise infrastructure patterns. Handles complex module design, multi-cloud deployments, GitOps workflows, policy as code, and CI/CD integration. Covers migration strategies, security best practices, and modern IaC ecosystems. Use PROACTIVELY for advanced IaC, state management, or infrastructure automation.

1
lambda-labs-gpu-cloud

Reserved and on-demand GPU cloud instances for ML training and inference. Use when you need dedicated GPU instances with simple SSH access, persistent filesystems, or high-performance multi-node clusters for large-scale training.

1
finding-security-misconfigurations

This skill enables Claude to identify potential security misconfigurations in various systems and configurations. It leverages the security-misconfiguration-finder plugin to analyze infrastructure-as-code, application configurations, and system settings, pinpointing common vulnerabilities and compliance issues. Use this skill when the user asks to "find security misconfigurations", "check for security vulnerabilities in my configuration", "audit security settings", or requests a security assessment of a specific system or file. This skill will assist in identifying and remediating potential security weaknesses.

0