{"type":"mcp_server","name":"mcp-server-runner","description":"MCP Server Runner is a WebSocket server that enables Model Context Protocol server access via WebSocket connections, facilitating integration with web applications and managing bidirectional communication between clients and the MCP server.","category":"Developer Tools","language":"Rust","stars":19,"forks":2,"owner":"yonaka15","github_url":"https://github.com/yonaka15/mcp-server-runner","homepage":null,"setup":"## Setup\n\n1.  **Prerequisites**: Ensure you have Rust 1.70 or higher and an MCP server implementation executable.\n2.  **Configuration**: Configure the application using environment variables or a JSON configuration file.\n3.  **Environment Variables**: Set `PROGRAM` (path to MCP server), `ARGS` (comma-separated arguments), `HOST` (host address), `PORT` (port), and `CONFIG_FILE` (path to JSON config).\n4.  **JSON Configuration**: Create a JSON file specifying server configurations, default server, host, and port.\n5.  **Usage with Environment Variables**: `export PROGRAM=npx`, `export ARGS=-y,@modelcontextprotocol/server-github`, `export PORT=8080`, `export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_***`, then `cargo run`.\n6.  **Usage with Configuration File**: `cargo run config.json` or `CONFIG_FILE=config.json cargo run`.\n7.  **Connect to WebSocket**: Use `const ws = new WebSocket(\"ws://localhost:8080\");` in your JavaScript code.\n8.  **Docker Support**: Use `docker-compose up --build` for containerized deployment.\n9.  **Development**: Build with `cargo build`, test with `cargo test`, and run with debug logging using `RUST_LOG=debug cargo run`.","tools":"## Available Tools\n\n1. WebSocket server implementation with single-client support (Enables MCP servers to be accessed via WebSocket connections).\n2. Process management for MCP server instances (Launches and manages MCP server processes).\n3. Bidirectional message passing between client and server (Handles communication between clients and the MCP server).\n4. Graceful shutdown handling (Supports graceful shutdown and error handling).\n5. Comprehensive error logging (Logs errors with detailed information).\n6. Cross-platform support (Unix/Windows) (Supports running on different operating systems).\n7. Docker Support (Dockerfile and docker-compose.yml are provided for containerized deployment).\n","faq":null,"created_at":"2024-12-08T15:54:48+00:00","updated_at":"2025-03-27T05:06:40+00:00","source_url":"https://model-context-protocol.com/servers/websocket-mcp-server-runner-integration","related_articles":[]}