Repository files navigation

• Multi-cloud storage provider support
• Unified API for file uploads
• Presigned URL generation for secure access
• Support for AWS S3, Alibaba Cloud OSS, Tencent Cloud COS, Qiniu Cloud, and GitHub
• Easy configuration via environment variables
• Customizable URL expiration times
• Support for custom domains and CDNs
• Dual operation modes: stdio for direct integration and SSE for server mode

go install github.com/sjzar/file-store-mcp@latest

1. Set the required environment variables for your chosen storage provider
2. Run in stdio mode (default) for direct integration with other applications:

   file-store-mcp

3. Or run in SSE server mode for HTTP-based integration:

   file-store-mcp --sse-port 8080

File Store MCP provides three tools for uploading files to cloud storage:

Uploads local files to cloud storage and returns HTTP URLs.

When to use: When users mention local file paths or need online access to their files. Ideal for analyzing PDF content, referencing local images for drawing tasks, or processing any local files.

Parameters:

• paths: Array of absolute local file paths to upload (required)

Example:

{"tool":"upload_files","params": {"paths": ["/path/to/file1.pdf","C:/Users/user/Documents/file2.jpg"]  }}

Uploads files from the clipboard to cloud storage and returns HTTP URLs.

When to use: Only when users explicitly request to upload files from their clipboard. Useful when users want to share or process clipboard content without saving it locally first.

Parameters: None required

Example:

{"tool":"upload_clipboard_files"}

Downloads files from provided URLs and uploads them to cloud storage, returning new HTTP URLs.

When to use: When users provide web links to files they want to process or analyze. Ideal for situations where users reference external files that need to be incorporated into the current workflow.

Parameters:

• urls: Array of URLs pointing to files to download and upload (required)

Example:

{"tool":"upload_url_files","params": {"urls": ["https://example.com/file1.pdf","https://another-site.org/image.jpg"]  }}

File Store MCP supports the following storage providers:

• AWS S3 (and compatible services like Cloudflare R2)
• Alibaba Cloud OSS
• Tencent Cloud COS
• Qiniu Cloud Storage
• GitHub Repository

SetFSM_STORAGE_TYPE=s3 to use AWS S3 or compatible services.

Notes for S3-compatible services:

• For Cloudflare R2: SetFSM_S3_ENDPOINT to your R2 endpoint URL
• For other S3-compatible services: Configure the appropriate endpoint URL

SetFSM_STORAGE_TYPE=oss to use Alibaba Cloud OSS.

SetFSM_STORAGE_TYPE=cos to use Tencent Cloud COS.

SetFSM_STORAGE_TYPE=qiniu to use Qiniu Cloud Storage.

Available Qiniu regions:

• z0: East China
• z1: North China
• z2: South China
• na0: North America
• as0: Southeast Asia

SetFSM_STORAGE_TYPE=github to use GitHub as a storage provider.

GitHub token permissions:

• The token must haverepo scope for private repositories
• For public repositories,public_repo scope is sufficient

For all storage providers, you can configure custom domains to serve your files. This is particularly useful when you have CDN services in front of your storage.

Example for Alibaba Cloud OSS with custom domain:

FSM_STORAGE_TYPE=ossFSM_OSS_BUCKET=my-bucketFSM_OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.comFSM_OSS_ACCESS_KEY=your-access-keyFSM_OSS_SECRET_KEY=your-secret-keyFSM_OSS_DOMAIN=cdn.example.com

Enable debug mode for more verbose logging:

file-store-mcp --debug

git clone https://github.com/sjzar/file-store-mcp.gitcd file-store-mcpgo build

This project is licensed under the Apache License 2.0 - see theLICENSE file for details.