MCP WebSocket Server

@virajsharma2000

Basic information

About MCP WebSocket Server

This server implements an MCP (Model Context Protocol) server with WebSocket enhancements for real-time data updates.

MCP WebSocket Server config

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

{
  "mcpServers": {
    "mcp-websocket": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

MCP WebSocket Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Overview

What is MCP WebSocket Server?

MCP WebSocket Server implements an MCP (Model Context Protocol) server with WebSocket enhancements for real-time data updates. It allows clients to make standard MCP requests and subscribe via WebSocket to receive push notifications when new data becomes available. This server is intended for developers who need real-time data streaming alongside standard MCP interactions.

How to use MCP WebSocket Server?

Clone the repository, install dependencies (pip install websockets mcp-sdk), then start both servers with python server.py. Clients connect to the WebSocket server at ws://localhost:8765 and send {"action": "subscribe"} to subscribe. Standard MCP requests are sent to http://localhost:8080 with a payload like {"method": "get_data"}.

Key features of MCP WebSocket Server

MCP Server on port 8080 for standard requests
WebSocket Server on port 8765 for real-time subscriptions
Push notifications to all subscribed clients
Async architecture using asyncio for efficient non-blocking operations

Use cases of MCP WebSocket Server

Subscribing to real-time data updates via WebSocket
Receiving push notifications when new data arrives
Making standard MCP request/response queries
Combining synchronous MCP calls with asynchronous streaming

Frequently asked questions

What ports does the server use?

The MCP server runs on port 8080, and the WebSocket server runs on port 8765.

How do I subscribe to WebSocket updates?

Send a JSON message `{"action": "subscribe"}` to the WebSocket server at `ws://localhost:8765`.

What dependencies are required?

Install `websockets` and `mcp-sdk` (replace with the actual MCP SDK package name).

How do I start the server?

Run `python server.py` from the cloned repository directory.

What license is this project under?

This project is licensed under the MIT License.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

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

26.0K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Codelf

unbug

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

14.2K