ws-mcp

nick1udwig/ws-mcp

🔗 Latest commit:15b5414

🕒 Updated:Sep 9, 2025, 01:06 PM

Python

AI Tools

MCP server from nick1udwig/ws-mcp

MCP Trust Score

Based on our comprehensive evaluation criteria

🤖 Evaluated by gemini-2.5-flashFix

Trust Score59/100

• Core MCP protocol features implemented (27/40)
• Room for improvement in GitHub community
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

GitHub Metrics

Repository statistics and activity

⭐ GitHub Stars:19

👥 Contributors:2

📋 Total Issues:0

📦 Has Releases:No

🔧 Has CI/CD Pipeline:No

Configuration

Configuration example extracted from README.md for Claude Desktop and other clients.

🤖 Evaluated by gemini-2.5-flashFix

{
  "mcp-server-fetch": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch"
    ],
    "env": {}
  },
  "wcgw_mcp-macos": {
    "command": "uvx",
    "args": [
      "--from",
      "wcgw@latest",
      "--python",
      "3.12",
      "wcgw_mcp"
    ],
    "env": {}
  },
  "wcgw_mcp-linux": {
    "command": "uvx",
    "args": [
      "--from",
      "/tmp/wcgw",
      "--with",
      "/tmp/wcgw/src/mcp_wcgw",
      "--python",
      "3.12",
      "wcgw_mcp"
    ],
    "env": {}
  },
  "modelcontextprotocol-server-brave-search-env-var": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-brave-search"
    ],
    "env": {
      "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
    }
  },
  "modelcontextprotocol-server-brave-search-env-file": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-brave-search"
    ],
    "env": {}
  },
  "modelcontextprotocol-server-brave-search-multiple": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-brave-search"
    ],
    "env": {}
  },
  "mcp-server-fetch-multiple": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch"
    ],
    "env": {}
  },
  "wcgw-default-configured": {
    "command": "uvx",
    "args": [
      "--from",
      "wcgw@latest",
      "--python",
      "3.12",
      "wcgw_mcp"
    ],
    "env": {}
  },
  "fetch-default-configured": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch"
    ],
    "env": {}
  }
}

MCP Protocol Support

Implemented MCP protocol features

🤖 Evaluated by gemini-2.5-flashFix

Tools:✓

Prompts:✗

Resources:✓

Sampling:✗

Roots:✓

Logging:✗

STDIO Transport:✓

HTTP Transport:✓

OAuth2 Auth:✗

Dependencies

3 dependencies

Libraries and frameworks used by this MCP server

🤖 Evaluated by gemini-2.5-flashFix

Main

websockets

jsonschema

Light

colorama

README.md

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:

Create your configuration file:
```
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:

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

# 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

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/nick1udwig/ws-mcp)](https://archestra.ai/mcp-catalog/nick1udwig__ws-mcp)

Edit This Server Add New MCP Server Report an Issue

README.md

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:

Create your configuration file:
```
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:

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

# 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