ws-mcp
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
Jump to
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ws-mcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



