Remote Storage MCP

Overview

What is Remote Storage MCP? Remote Storage MCP is a Model Context Protocol (MCP) integration that enables seamless file sharing and transfer through multiple cloud storage providers. It provides a simple interface for uploading and downloading files via natural language commands, making file sharing accessible directly from your AI assistant.

Currently supported storage providers:

• DeepPCB Storage - DeepPCB API for board or constraints file uploads
• FileBin - filebin.net for anonymous file sharing

Installation

Make sure you have Python 3.10+, then install the required dependencies:

pip install -r requirements.txt

Configuration

Option 1: DeepPCB Storage

1. Get your DeepPCB API key from the DeepPCB platform
2. Add your DeepPCB MCP server in your MCP client config:

{
  "mcpServers": {
    "deeppcb_storage": {
      "command": "python path/to/deeppcb_storage_mcp.py",
      "env": {
        "API_KEY": "YOUR_DEEPPCB_API_KEY",
        "BASE_URL": "https://api.deeppcb.ai/v1"
      }
    }
  }
}

Option 2: FileBin Storage

1. Create a new bin at https://filebin.net. You'll be redirected to a unique bin ID.
2. Add your FileBin MCP server in your MCP client config:

{
  "mcpServers": {
    "file_bin": {
      "command": "python path/to/filebin_mcp.py",
      "env": {
        "BIN_ID": "YOUR_BIN_ID",
        "BASE_URL": "https://filebin.net"
      }
    }
  }
}

Features & Use Cases

Seamless File Upload

• Upload Any File Type Upload documents, images, code files, board files, or any other file type to your cloud storage
• Automatic File Naming Smart file naming based on the original file path, handling both files and directories
• Binary File Support Full support for binary files with proper content-type handling

Simple Integration

• Environment-Based Configuration Easy setup using environment variables for storage management
• FastMCP Framework Built on FastMCP for reliable and efficient MCP communication
• Error Handling Comprehensive error reporting for failed uploads or downloads

Tools

Both storage providers expose the following tools:

Upload_file_to_cloud

Uploads a file to your configured cloud storage provider.

• Parameters:
  • file_path: Path to the file you want to upload (local file path)
• Returns:
  • status: HTTP status code
  • url: The uploaded file URL
  • failure_reason: Error message if upload fails (empty on success)

Contributing

Please read our contributing docs for details on how to submit pull requests, our Contributor License Agreement and community guidelines.

FAQ

Q: Which storage provider should I use? A:

• Use FileBin for general file sharing, anonymous uploads, and when you need download capabilities
• Use DeepPCB Storage for uploading board or constraints files to the DeepPCB platform

Q: Do I need to create a filebin account? A: No, filebin.net allows anonymous bin creation. Simply visit https://filebin.net/ to create a new bin and get your bin ID.

Q: How long do files stay in the bin? A: For FileBin, files have a retention period which is a week when developing this MCP. Check filebin.net's terms of service for specific retention policies. For DeepPCB Storage, the signed URLs expire in 24 hours.

Q: Can I share files with others? A: Yes! For FileBin, files can be accessed by anyone with the bin ID and filename. For DeepPCB Storage, you'll receive a signed URL that can be shared (valid for 24 hours).