How do I configure which MCP servers to run?

You create or modify a JSON config file specifying the MCP servers, or use command-line --command flags.

Can I run multiple MCP servers at once?

Yes, you can specify multiple --command options or list multiple servers in the config file.

How do I pass API keys or environment variables to wrapped servers?

Use --env or --env-file flags when running ws-mcp to inject environment variables.

What port does ws-mcp use by default?

The default port is 10125, but you can specify a different port with the --port flag.

Ws MCP

websocketmcpintegrationstdio

Wrap MCP stdio servers with a WebSocket interface for integration with kibitz and other tools.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

The install command below didn't complete successfully in our automated test.

uvx --refresh

[not_found] process with pid 1999 not found

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

ws-mcp wraps existing MCP servers that run over stdio with a WebSocket interface, enabling them to be accessed over network sockets. It is useful when you want to expose MCP servers through WebSocket connections, for example to integrate with the kibitz client or other WebSocket-based tools. Configuration allows running multiple MCP servers concurrently on specified ports.

Use cases

Expose MCP stdio servers over WebSocket

Run multiple MCP servers concurrently with WebSocket access

Integrate MCP servers with kibitz or other WebSocket clients

Configure custom MCP server sets via JSON config files

Use environment variables to pass credentials to wrapped servers

Key features

Wraps any MCP stdio server with WebSocket transport

Supports multiple MCP servers running simultaneously

Configurable via JSON file or command-line commands

Supports environment variable injection for wrapped servers

Default config includes wcgw and fetch MCP servers

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Ws MCP.

Extracted Tool Capabilities

Wraps any MCP stdio server with WebSocket transport

Supports multiple MCP servers running simultaneously

Configurable via JSON file or command-line commands

Supports environment variable injection for wrapped servers

Default config includes wcgw and fetch MCP servers

Documentation Overview

ws-mcp

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

Quickstart

Prerequisites

Install uv:

Terminal

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:

Create your configuration file:
bash
```
cp sample.config.json config.json
```
Modify config.json to add or remove servers based on your needs.
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:

bash

uvx --refresh ws-mcp@latest

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

To use a config file and port:

bash

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

Detailed Usage

server.ts

# Example using fetch
uvx --refresh ws-mcp --command "uvx mcp-server-fetch" --port 3002

# Example using wcgw
uvx --refresh ws-mcp --command "uvx --from wcgw@latest --python 3.12 wcgw_mcp" --port 3001

# Example using Brave search
export BRAVE_API_KEY=YOUR_API_KEY_HERE
uvx --refresh ws-mcp --env BRAVE_API_KEY=$BRAVE_API_KEY --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003

# Or, with a .env file:
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003

# `--command` can be supplied multiple times!
#  Example serving multiple servers at once:
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --command "uvx mcp-server-fetch" --port 3004

# 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)
uvx --refresh ws-mcp --env-file path/to/.env --config path/to/config.json --port 3005

Read the full README →View source on GitHub →

Related MCP Servers

View all in Other Tools and Integrations View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

11mo ago

Most recent push to the default branch.

Install check

Inconclusive

Install command did not finish in our automated test.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ws MCP

It wraps MCP servers that communicate over stdio with a WebSocket interface, allowing network access.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ws-mcp?style=directory)](https://allmcps.com/mcp/ws-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/ws-mcp"><img src="https://allmcps.com/api/badge/ws-mcp?style=directory" alt="Ws MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryOther Tools and Integrations

PricingFree

10/11 checks healthy over the last 33d

39Quality signal: Fair · 39/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · --refresh (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🛠️ Other Tools and Integrations →Alternatives to Ws MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Ws MCP

websocketmcpintegrationstdio

Wrap MCP stdio servers with a WebSocket interface for integration with kibitz and other tools.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

The install command below didn't complete successfully in our automated test.

uvx --refresh

[not_found] process with pid 1999 not found

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Expose MCP stdio servers over WebSocket

Run multiple MCP servers concurrently with WebSocket access

Integrate MCP servers with kibitz or other WebSocket clients

Configure custom MCP server sets via JSON config files

Use environment variables to pass credentials to wrapped servers

Key features

Wraps any MCP stdio server with WebSocket transport

Supports multiple MCP servers running simultaneously

Configurable via JSON file or command-line commands

Supports environment variable injection for wrapped servers

Default config includes wcgw and fetch MCP servers

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Ws MCP.

Extracted Tool Capabilities

Wraps any MCP stdio server with WebSocket transport

Supports multiple MCP servers running simultaneously

Configurable via JSON file or command-line commands

Supports environment variable injection for wrapped servers

Default config includes wcgw and fetch MCP servers

Documentation Overview

ws-mcp

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

Quickstart

Prerequisites

Install uv:

Terminal

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:

Create your configuration file:
bash
```
cp sample.config.json config.json
```
Modify config.json to add or remove servers based on your needs.
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:

bash

uvx --refresh ws-mcp@latest

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

To use a config file and port:

bash

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

Detailed Usage

server.ts

# Example using fetch
uvx --refresh ws-mcp --command "uvx mcp-server-fetch" --port 3002

# Example using wcgw
uvx --refresh ws-mcp --command "uvx --from wcgw@latest --python 3.12 wcgw_mcp" --port 3001

# Example using Brave search
export BRAVE_API_KEY=YOUR_API_KEY_HERE
uvx --refresh ws-mcp --env BRAVE_API_KEY=$BRAVE_API_KEY --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003

# Or, with a .env file:
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --port 3003

# `--command` can be supplied multiple times!
#  Example serving multiple servers at once:
uvx --refresh ws-mcp --env-file path/to/.env --command "npx -y @modelcontextprotocol/server-brave-search" --command "uvx mcp-server-fetch" --port 3004

# 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)
uvx --refresh ws-mcp --env-file path/to/.env --config path/to/config.json --port 3005

Read the full README →View source on GitHub →

Related MCP Servers

View all in Other Tools and Integrations View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

11mo ago

Most recent push to the default branch.

Install check

Inconclusive

Install command did not finish in our automated test.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ws MCP

It wraps MCP servers that communicate over stdio with a WebSocket interface, allowing network access.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ws-mcp?style=directory)](https://allmcps.com/mcp/ws-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/ws-mcp"><img src="https://allmcps.com/api/badge/ws-mcp?style=directory" alt="Ws MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryOther Tools and Integrations

PricingFree

10/11 checks healthy over the last 33d

39Quality signal: Fair · 39/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity3/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · --refresh (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🛠️ Other Tools and Integrations →Alternatives to Ws MCP →Install in Claude Desktop Install in Cursor Install in VS Code