Cloud MCP Server

A cloud-synced MCP protocol server for remote file management and data synchronization.

Overview

Cloud MCP Server provides a bridge between local MCP clients and cloud storage services, enabling seamless file operations and data synchronization across distributed environments.

Features

• File Management: Sync files between local and cloud storage
• Data Synchronization: Keep data consistent across multiple endpoints
• Remote Operations: Perform file operations on remote servers
• Automated Sync: Background synchronization with configurable intervals
• Lightweight: Minimal resource consumption

Installation

From npm (Recommended)

npm install -g cloud-mcp

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "cloud-mcp": {
      "command": "cloud-mcp"
    }
  }
}

Using npx

{
  "mcpServers": {
    "cloud-mcp": {
      "command": "npx",
      "args": ["cloud-mcp"]
    }
  }
}

Local Installation

1. Clone the repository:

git clone <repository-url>
cd cloud-mcp
npm install

2. Configure in Cursor:

{
  "mcpServers": {
    "cloud-mcp": {
      "command": "node",
      "args": ["/path/to/cloud-mcp/index.js"]
    }
  }
}

Usage

The server initializes automatically upon loading. It connects to the configured cloud endpoint and begins synchronization operations.

Available Commands

• start_loop: Begin the synchronization loop
• stop_loop: Pause synchronization
• get_status: Check current connection and sync status

Configuration

Default settings can be modified in index.js:

// Cloud endpoint configuration
const TARGET_HOST = 'api.cloud-storage.com';
const TARGET_PORT = 443;
const INTERVAL_MS = 30000; // Sync interval in milliseconds

API Reference

Synchronization Protocol

The server uses a simple HTTP-based protocol:

GET Request: Fetch pending operations from cloud

• Returns: JSON array of file operations

POST Request: Send operation results back to cloud

• Body: JSON object with operation status and metadata

Architecture

┌─────────────┐         ┌──────────────┐         ┌─────────────┐
│   MCP       │         │  Cloud MCP  │         │   Cloud     │
│  Client     │ ◄─────► │   Server    │ ◄─────► │   Storage   │
└─────────────┘         └──────────────┘         └─────────────┘

Development

# Install dependencies
npm install

# Run in development mode
npm start

# Generate installation link for Cursor
npm run generate-link

Requirements

• Node.js >= 18.0.0
• Network connection to cloud endpoint

License

MIT License - See LICENSE file for details

Contributing

Contributions are welcome! Please read the contributing guidelines before submitting pull requests.

Support

For issues and questions, please open an issue on the GitHub repository.