MCP WebSocket Server

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

FAQ from MCP WebSocket Server

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.