How do I install Ws MCP?

Install Ws MCP with a single command: npx mdskills install nick1udwig/ws-mcp. This downloads the skill files into your project and your AI agent picks them up automatically.

What platforms support Ws MCP?

Ws MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.

← Back to MCP servers

Ws MCP

Name: Ws MCP: AI Agent Skill
Rating: 7 (1 reviews)
Author: nick1udwig

Verified

MCP ServerIntermediate

Wrap MCP stdio servers with a WebSocket. For use with kibitz. Install uv: 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: 2. Modify config.json to add or remove servers

by @nick1udwig0Updated 1 weeks ago

Add this skill

npx mdskills install nick1udwig/ws-mcp

Fork & Edit

Skill Advisor7.0

Provides WebSocket wrapper for stdio MCP servers with clear setup and flexible configuration options

+Enables WebSocket access to stdio-based MCP servers for remote connectivity
+Provides clear examples for single and multiple server configurations
+Supports flexible configuration via CLI args, config files, and environment variables
-Lacks documentation on security considerations for exposing servers over WebSocket
-Permissions may be overly broad given wrapper nature (inherits from wrapped servers)

SKILL.md

Edit in Browser

1# ws-mcp
2 
3Wrap MCP stdio servers with a WebSocket.
4For use with [kibitz](https://github.com/nick1udwig/kibitz).
5 
6## Quickstart
7 
8### Prerequisites
9 
10Install [uv](https://github.com/astral-sh/uv):
11```bash
12curl -LsSf https://astral.sh/uv/install.sh | sh
13```
14 
15### Configuration
16 
17The config file specifies which MCP servers to run.
18The default config (no `--config` or `--command` args provided) includes:
19- [`wcgw`](https://github.com/rusiaaman/wcgw): For general system operations and file management
20- [`fetch`](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch): For making HTTP requests
21 
22To make a configuration file:
23 
241. Create your configuration file:
25   ```bash
26   cp sample.config.json config.json
27   ```
282. Modify `config.json` to add or remove servers based on your needs.
293. Run with `--config path/to/config.json` to use the new config file.
30 
31### Running ws-mcp
32 
33Basic usage with default config file (no `--config` or `--command` provided) and port:
34```bash
35uvx --refresh ws-mcp@latest
36```
37 
38This will start all configured servers on the default port (`10125`).
39 
40To use a config file and port:
41```bash
42uvx --refresh ws-mcp@latest --config path/to/config --port 10125
43```
44 
45## Detailed Usage
46 
47```bash
48# Example using fetch
49uvx --refresh ws-mcp --command "uvx mcp-server-fetch" --port 3002
50 
51# Example using wcgw
52uvx --refresh ws-mcp --command "uvx --from wcgw@latest --python 3.12 wcgw_mcp" --port 3001
53 
54# Example using Brave search
55export BRAVE_API_KEY=YOUR_API_KEY_HERE
56uvx --refresh ws-mcp --env BRAVE_API_KEY=$BRAVE_API_KEY --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003
57 
58# Or, with a .env file:
59uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003
60 
61# `--command` can be supplied multiple times!
62#  Example serving multiple servers at once:
63uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --command "uvx mcp-server-fetch" --port 3004
64 
65# Servers can also be specified in a `.json` file following [the standard MCP format](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)
66uvx --refresh ws-mcp --env-file path/to/.env --config path/to/config.json --port 3005
67```
68

Full transparency — inspect the skill content before installing.