drio
Open app

MCP Server Runner

Source

A WebSocket server implementation for running Model Context Protocol (MCP) servers. This application enables MCP servers to be accessed via WebSocket connections, facilitating integration with web applications and other network-enabled clients.

Catalog onlyCatalog onlySTDIO

Overview

MCP Server Runner is a WebSocket server implementation designed to run Model Context Protocol (MCP) servers, facilitating their access via WebSocket connections for easy integration with web applications and network-enabled clients.

To use MCP Server Runner, you need to set environment variables specifying your MCP server's executable path and other parameters, then run the server using the cargo command. After that, clients can connect to the WebSocket server for communication.

  • WebSocket server implementation with bidirectional message passing. - Process management for running MCP server instances. - Error logging and graceful shutdown handling. - Cross-platform support for Unix and Windows. - Docker support for containerized deployment.
  1. Integrating MCP servers with web client applications.
  2. Facilitating real-time data communication between client and server.
  3. Running simulations or applications requiring Model Context Protocol functionality.

Add to your AI client

Use these steps to connect MCP Server Runner in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-runner-yonaka15": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-runner-yonaka15"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-runner-yonaka15": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-runner-yonaka15"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-runner-yonaka15": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-runner-yonaka15"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-runner-yonaka15": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-runner-yonaka15"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-runner-yonaka15": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-runner-yonaka15"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-runner-yonaka15": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-runner-yonaka15"
      ]
    }
  }
}

FAQ

Does MCP Server Runner support multiple clients?

No, it currently supports only one client connection at a time.

Is SSL/TLS supported?

No, you need to use a reverse proxy for secure connections.

What prerequisites are needed to run MCP Server Runner?

You need Rust 1.70 or higher and an executable for the MCP server.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":314,"uuid":"582138c5-fec4-4e82-84d7-8b4bf7e76c6f","name":"mcp-server-runner","title":"MCP Server Runner","description":"A WebSocket server implementation for running Model Context Protocol (MCP) servers. This application enables MCP servers to be accessed via WebSocket connections, facilitating integration with web applications and other network-enabled clients.","avatar_url":"https://avatars.githubusercontent.com/u/10888995?v=4","created_at":"2024-12-13T13:03:47.978Z","updated_at":"2024-12-13T15:09:10.100Z","status":"created","author_name":"yonaka15","author_avatar_url":"https://avatars.githubusercontent.com/u/10888995?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/yonaka15/mcp-server-runner","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"4\",\"license\":\"MIT license\",\"language\":\"Rust\",\"is_official\":false,\"latest_commit_time\":\"2025-03-17 10:22:31\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools