Moonshot MCP Server Gateway

Moonshot MCP Server Gateway acts as a lightweight gateway that provides a unified entry point for accessing multiple MCP servers. It simplifies connection management, supports multiple transport protocols, and lets you route client requests to different MCP sub-servers through configurable prefixes.

How to use

You connect clients to the Moonshot gateway to access several MCP sub-servers through a single entry point. Use the configured API routing prefixes to direct clients to the right sub-server, whether you’re using HTTP(S) endpoints or local process-based MCPs. Start from a cloud-friendly setup where the gateway exposes a centralized URL and forwards requests to the appropriate MCP backends.

How to install

Prerequisites: ensure you have Python installed and a compatible runtime available. You will also need the tool used to run the gateway in your environment.

1. Clone the project repository. 2) Prepare environment configuration files for your deployment. 3) Start the gateway in your preferred mode.

git clone https://github.com/MarshallEriksen-shaomingyang/moonshot-mcp-server.git
cp .env.example .env
cp moonshot_config.example.toml moonshot_config.toml
# Create virtual environment
uv venv
# Activate virtual environment
source .venv/bin/activate
# Start the gateway in HTTP mode or SSE mode
uv run server.py --mode http
# or
uv run server.py --mode sse

Additional configuration and usage notes

Configuration for the gateway defines the main server properties and the list of sub-servers (MCP backends). The structure includes a server block with basic settings and an mcpServers block where each sub-server specifies its type, routing prefix, and connection details.

# Basic server configuration
[server]
name = "AlphaCore Server Gateway"
version = "1.0.0"
port = 8090
host = "0.0.0.0"

# Process server example
[mcpServers.python_server]
type = "process"
command = "python3"
script_path = "server.py"
prefix = "py"
cwd = "/data/moonshot_tools"

# HTTP server example
[mcpServers.http_server]
type = "https"
url = "https://api.example.com/mcp"
prefix = "api"

Security and operational notes

Limit access to the gateway by configuring appropriate host filtering, TLS termination, and API routing prefixes. For sub-servers that run locally, ensure the working directories and script paths have correct permissions and that environment variables are secured.