ws-mcp

by nick1udwig

21 stars
217 downloads
Not rated
GitHub

Description

# ws-mcp Wrap MCP stdio servers with a WebSocket. For use with [kibitz](https://github.com/nick1udwig/kibitz). ## Quickstart ### Prerequisites Install [uv](https://github.com/astral-sh/uv): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` ### Configuration The config…

About

# ws-mcp Wrap MCP stdio servers with a WebSocket. For use with [kibitz](https://github.com/nick1udwig/kibitz). ## Quickstart ### Prerequisites Install [uv](https://github.com/astral-sh/uv): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` ### Configuration The config file specifies which MCP servers to run…

Details

Author
nick1udwig
GitHub stars
21
Downloads
217
Categories
Other

- Wraps MCP stdio servers with WebSocket.
- Supports configuration via file or --command flags.
- Run multiple MCP servers simultaneously.
- Pass environment variables inline or from a .env file.
- Default port 10125, configurable with --port.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name ws-mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install uv, then run uvx --refresh ws-mcp@latest with optional flags. Configure servers via a JSON config file (--config) or command-line arguments (--command). Set the port with --port (default 10125), and pass environment variables via --env or --env-file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ws-mcp": {
            "ws-mcp": {
                "command": "uvx",
                "args": [
                    "--refresh",
                    "ws-mcp@latest"
                ]
            }
        }
    }
}

McpServers

{
    "ws-mcp": {
        "command": "uvx",
        "args": [
            "--refresh",
            "ws-mcp@latest"
        ]
    }
}

ws-mcp

Wrap MCP stdio servers with a WebSocket.
For use with kibitz.

Quickstart

Prerequisites

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Configuration

The config file specifies which MCP servers to run.
The default config (no --config or --command args provided) includes:
- wcgw: For general system operations and file management
- fetch: For making HTTP requests

To make a configuration file:

1. Create your configuration file:

   cp sample.config.json config.json

2. Modify config.json to add or remove servers based on your needs.
3. Run with --config path/to/config.json to use the new config file.

Running ws-mcp

Basic usage with default config file (no --config or --command provided) and port:

uvx --refresh ws-mcp@latest

This will start all configured servers on the default port (10125).

To use a config file and port:

uvx --refresh ws-mcp@latest --config path/to/config --port 10125

Detailed Usage

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.