ws-mcp

@nick1udwig

About ws-mcp

No overview available yet

Basic information

Category

Other

Runtime

python

Transports

stdio

Publisher

nick1udwig

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ws-mcp?

ws-mcp wraps MCP stdio servers with a WebSocket connection, designed for use with kibitz. It allows you to expose one or more MCP servers over a WebSocket port.

How to use ws-mcp?

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.

Key features of ws-mcp

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.

Use cases of ws-mcp

Run MCP servers locally for integration with kibitz.
Expose a fetch server over WebSocket for HTTP requests.
Expose wcgw for system operations and file management.
Expose Brave search with an API key via WebSocket.

FAQ from ws-mcp

What prerequisites are needed?

Install uv, a Python project manager, via curl -LsSf https://astral.sh/uv/install.sh | sh.

How do I configure which MCP servers to run?

Use a JSON config file (--config path/to/config.json) or supply one or more --command flags.

Does ws-mcp support multiple servers at once?

Yes, you can provide multiple --command flags or use a config file listing several servers.

How do I pass environment variables to a server?

Use --env KEY=VALUE or --env-file path/to/.env to set variables for a server.

What is the default port?

The default port is 10125, but you can override it with the --port flag.

Comments

More Other MCP servers

🪟 Windows-MCP

MCP Server for Computer Use in Windows

MCP Go 🚀

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

FastMCP v2 🚀

🚀 The fast, Pythonic way to build MCP servers and clients.

Codelf

A search tool helps dev to solve the naming things problem.

Core Philosophy: Connect, Unify, Respond

Delegate anything. It comes back done.