ws-mcp
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…
Explore
- 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:
curl -LsSf https://astral.sh/uv/install.sh | sh
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
uvx --refresh ws-mcp --env-file path/to/.env --config path/to/config.json --port 3005
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"
]
}
}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.
