Package Exports

@zhigang1992/uploadfile-mcp
@zhigang1992/uploadfile-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@zhigang1992/uploadfile-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

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