MCP Server Runner

Note: This project is under active development. Features and APIs may change.

MCP Server Runner is a WebSocket server for running Model Context Protocol (MCP) servers, enabling access via WebSocket connections for integration with web applications.

Overview

It acts as a bridge between WebSocket clients and MCP servers by launching the server process, managing WebSocket connections, and handling bidirectional communication.

Features

• WebSocket server with single-client support
• Process management for MCP server instances
• Bidirectional message passing
• Graceful shutdown
• Comprehensive error logging
• Cross-platform support

Prerequisites

• Rust 1.70+
• An MCP server executable

Configuration

Configuration is possible through environment variables or a JSON configuration file, which allows defining multiple server configurations.

Usage

The server can be run using environment variables or a configuration file. Connect to the WebSocket server using a WebSocket client.

Docker Support

Dockerfile and docker-compose.yml are provided for containerized deployment.

Limitations

• Supports only one client connection
• No WebSocket SSL/TLS support
• No built-in authentication