Shadow

You run MCP Server to host and coordinate multiple MCP services, connect them via different transports, and automate workflows with tool chains. It supports SSE and stdio, WebSocket connections, auto-reload on config changes, and a pluggable tool system so you can compose complex automation without rebuilding every time.

How to use

You can operate MCP Server from the command line or embed it into your application. Choose a transport mode that fits your setup: SSE for standard web-oriented connections or stdio for local child processes. You can also connect to remote MCP services via WebSocket.

Start a standalone MCP service with a configuration file that describes the MCP servers you want to run. The system can automatically reload when you change the mcp-config file or your JavaScript configuration, keeping your setup up-to-date without manual restarts.

If you want to enable WebSocket mode to connect to a service like xiaozhi.me, run with a WebSocket URL and the corresponding mcp configuration file. This enables real-time bidirectional communication and unified management of multiple MCP services.

To combine multiple MCP services, use a single configuration that defines several servers and transports (SSE and stdio) together. This lets you tailor the system to your application’s topology and performance needs.

How to install

Prerequisites you need: Node.js and npm or yarn for building and running the MCP server binary or dev scripts.

Step-by-step setup you can follow now:

# Install dependencies
npm install

# Build the project (if a build script is provided)
yarn build # or npm run build

# Run the server (default mode)
npm start

# For development with SSE mode
npm run dev

# WebSocket development (if available)
npm run dev-ws

# Cronjob development
npm run dev-cronjob

Additional sections

Configuration format lets you define MCP behavior directly alongside server options. You can export a function to configure resources and tools, and optionally provide an mcpConfig object that lists servers, tools, and namespaces.

Available tools

get_product_hunt_url

Fetches the Product Hunt page URL for the workflow.

load_product_hunt_js_code

Loads JavaScript code from Product Hunt for processing.

browser_navigate

Navigate to a URL within the browser tool.

browser_execute_javascript

Execute JavaScript in the browser context and capture results.

browser_close

Close the browser session and clean up resources.