MCP Host Server

A multi-tenant remote MCP (Model Context Protocol) server hosting platform built for DigitalOcean deployment. This server allows multiple applications to connect to and use various MCP servers remotely over WebSocket connections.

Features

🏗️ Multi-tenant Architecture: Isolated MCP servers for different tenants
🔒 Secure Authentication: JWT-based authentication with role-based access
🌐 Remote Access: WebSocket-based connections for remote MCP usage
📊 Management API: RESTful API for server management
🛡️ Security: Rate limiting, input validation, CORS protection
📈 Scalable: Designed for cloud deployment on DigitalOcean

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │    │   MCP Client    │    │   MCP Client    │
│  (Claude, etc.) │    │   (API App)     │    │   (Custom)      │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │ WebSocket Connections
                    ┌────────────▼────────────┐
                    │   MCP Host Server       │
                    │   ┌─────────────────┐   │
                    │   │ Tenant A        │   │
                    │   │ ├ File Server   │   │
                    │   │ ├ DB Server     │   │
                    │   │ └ API Server    │   │
                    │   ├─────────────────┤   │
                    │   │ Tenant B        │   │
                    │   │ ├ Custom Server │   │
                    │   │ └ File Server   │   │
                    │   └─────────────────┘   │
                    └─────────────────────────┘

Quick Start

1. Installation

# Clone the repository
git clone https://github.com/motionmavericks/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Copy environment file
cp .env.example .env

2. Configuration

Edit .env file with your settings:

PORT=3000
JWT_SECRET=your_secret_here
ALLOWED_ORIGINS=https://yourdomain.com
ADMIN_PASSWORD=YourSecurePassword123!

3. Development

# Start in development mode
npm run dev

# Or start normally
npm start

4. Production Deployment

# Set environment to production
export NODE_ENV=production

# Start the server
npm start

API Usage

Authentication

# Login
curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "admin@mcp.mvrx.com.au", "password": "SecureMCP2024!"}'

Create MCP Server

# Create a file manager server
curl -X POST http://localhost:3000/api/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My File Server",
    "type": "file-manager",
    "description": "File management MCP server"
  }'

Get Connection URL

# Get WebSocket connection URL for MCP client
curl -X POST http://localhost:3000/api/servers/SERVER_ID/connect \
  -H "Authorization: Bearer YOUR_TOKEN"

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "remote-file-server": {
      "command": "node",
      "args": ["path/to/mcp-websocket-client.js"],
      "env": {
        "MCP_SERVER_URL": "ws://mcp.mvrx.com.au:3001/mcp-ws?tenant=TENANT_ID&server=SERVER_ID&token=CONNECTION_TOKEN"
      }
    }
  }
}

Custom MCP Client

import { WebSocket } from 'ws';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const ws = new WebSocket('ws://mcp.mvrx.com.au:3001/mcp-ws?tenant=TENANT_ID&server=SERVER_ID&token=CONNECTION_TOKEN');
const client = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });

await client.connect(new WebSocketClientTransport(ws));

// Use MCP tools
const tools = await client.listTools();
console.log('Available tools:', tools);

Available MCP Server Types

File Manager

read_file: Read file contents
write_file: Write file contents
list_files: List directory contents

Database

query_database: Execute SQL queries

API Client

api_request: Make HTTP API requests

Custom

Define your own tools and resources

Security Features

JWT Authentication: Secure token-based authentication
Rate Limiting: Prevents abuse and DoS attacks
Input Validation: Sanitizes all inputs
CORS Protection: Configurable cross-origin policies
Security Headers: Helmet.js security headers
Request Logging: Comprehensive audit logging

Deployment on DigitalOcean

App Platform

Create new app from GitHub repository
Set environment variables in App Platform dashboard
Configure custom domain (optional)
Deploy!

Example App Spec

name: mcp-host-server
services:
- name: api
  source_dir: /
  github:
    repo: motionmavericks/mcp-server
    branch: main
  run_command: npm start
  environment_slug: node-js
  instance_count: 2
  instance_size_slug: apps-s-1vcpu-1gb
  http_port: 3000
  envs:
  - key: NODE_ENV
    value: production
  - key: JWT_SECRET
    value: YOUR_SECRET
  - key: ALLOWED_ORIGINS
    value: https://mcp.yourdomain.com

Monitoring

Health Check

curl http://localhost:3000/health

System Status

curl -H "Authorization: Bearer TOKEN" \
  http://localhost:3000/api/status

Development

Project Structure

src/
├── config/           # Configuration management
├── middleware/       # Express middleware
├── routes/          # API routes
├── services/        # Business logic
└── utils/           # Utilities

Adding New MCP Server Types

Extend MCPServerManager.registerServerTools()
Add new tool handlers
Update validation in API routes
Add tests

Testing

npm test

Contributing

Fork the repository
Create feature branch (git checkout -b feature/new-feature)
Commit changes (git commit -am 'Add new feature')
Push to branch (git push origin feature/new-feature)
Create Pull Request

License

MIT License - see LICENSE file for details.

Support

GitHub Issues: https://github.com/motionmavericks/mcp-server/issues
Documentation: https://github.com/motionmavericks/mcp-server/wiki
Email: support@motionmavericks.com.au

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A multi-tenant remote server platform that enables applications to connect to Model Context Protocol servers over WebSocket connections, allowing secure access to file management, database, and API capabilities.

Related MCP Servers

MCP Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
1,133
1
Python
Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
UseGrant MCP Serverofficial
usegranthq
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for managing providers, clients, tenants, and access tokens through the UseGrant platform.
Last updated -
26
116
JavaScript
MIT License
Loveable.dev MCP Server
iamseancorcoran
-
security
A
license
-
quality
A Model Context Protocol server that enables users to create, check status, and get details of projects on Loveable.dev, a platform for quickly creating applications.
Last updated -
JavaScript
ISC License

View all related MCP servers