ws-mcpws-mcp MCP server

— (0)

Reviewed by Daniel Nikulshyn·Updated July 2026

Overview

ws-mcp is a tool that wraps MCP stdio servers with a WebSocket, primarily for use with kibitz. It allows users to create MCP servers for various tasks such as general system operations, file management, and making HTTP requests. The tool requires configuration to specify which MCP servers to run, and users can create their own configuration files to customize their setup. The default configuration includes servers for general system operations (wcgw) and HTTP requests (fetch). The tool can be run using the uvx command with various options, including specifying a configuration file, port, and environment variables. It supports serving multiple servers at once and can be used with different MCP servers, such as those for Brave search.

Key features

WebSocket support
MCP server wrapping
Configurable via JSON
Support for multiple commands
Environment variable support

Pricing

Model: Free
Category: MCP Servers
Rating: No reviews yet

Use cases

General System Operations

Use ws-mcp to run wcgw server for general system operations and file management

HTTP Requests

Use ws-mcp to run fetch server for making HTTP requests

Multiple Server Support

Use ws-mcp to serve multiple MCP servers at once, such as Brave search and fetch servers

Pros & Cons

Pros

Enables MCP servers to be used with WebSocket
Supports multiple MCP servers
Configurable via JSON file

Cons

Limited documentation
Requires uv and specific configuration

Reviews

No reviews yet. Be the first!

Q&A

What are the main limitations of ws-mcp?

Documentation is minimal and it relies on the `uv` package for installation. Users must manually edit the JSON config or use command-line flags, which may be challenging for those unfamiliar with MCP or WebSocket setups.

Asked by Mohammed Al-Amin · Jun 1, 2026

Can ws-mcp serve multiple MCP servers simultaneously?

Yes. You can supply multiple `command` entries or list several servers in a single JSON config. Each server can run on its own port, allowing parallel operation of, for example, wcgw, fetch, and Brave search.

Asked by Joanna Kowalski · May 30, 2026

What ports does ws-mcp use by default and how can I change them?

If no port is specified, ws-mcp runs all configured servers on the default port 10125. To use a different port, add the `port <number>` option in the command line or set it in the JSON config for each server.

Asked by Lior Ben-David · May 24, 2026

How do I configure ws-mcp to run custom MCP servers?

Create a JSON file based on sample.config.json, editing the "servers" section to add or remove server names and their options. Then start ws-mcp with `uvx refresh ws mcp@latest config path/to/config.json` or specify individual commands with `uvx mcp server <name> port <port>`.

Asked by Ivo Novotný · Mar 2, 2026