drio
Open app

WebSocket MCP

Source

Model Context Protocol (MCP) server and client with a custom websocket transport layer.

Catalog onlyCatalog onlySTDIO

Overview

WebSocket MCP is a project that implements a websockets-based Model Context Protocol (MCP) server and client, designed to enhance communication between clients and local LLMs (Large Language Models).

To use WebSocket MCP, you can run the server and client using command-line arguments. The server can be started with default settings for local operation, and the client can connect to the server to send prompts and receive responses.

  • Robust MCP server implementation for efficient message exchange. - Generic MCP client for interacting with servers, supporting resource listing and data streaming. - Local LLM server for generating responses based on prompts. - Flexibility to support various LLM models and configurations.
  1. Building interactive applications that require real-time communication with LLMs.
  2. Developing chatbots that utilize local LLMs for generating responses.
  3. Facilitating data streaming and resource management in applications using LLMs.

Add to your AI client

Use these steps to connect WebSocket MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "websocket-mcp-zeropointo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-websocket-mcp-zeropointo"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "websocket-mcp-zeropointo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-websocket-mcp-zeropointo"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "websocket-mcp-zeropointo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-websocket-mcp-zeropointo"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "websocket-mcp-zeropointo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-websocket-mcp-zeropointo"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "websocket-mcp-zeropointo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-websocket-mcp-zeropointo"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "websocket-mcp-zeropointo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-websocket-mcp-zeropointo"
      ]
    }
  }
}

FAQ

What is the purpose of the WebSocket MCP?

The purpose is to create a better MCP implementation that overcomes limitations of standard transport layers.

Is WebSocket MCP easy to set up?

Yes! It can be configured and run using simple command-line commands.

Can I use different LLM models with WebSocket MCP?

Yes! The project is designed to be flexible and supports various LLM models.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2028,"uuid":"2172a928-d262-42c4-b2cc-3499b4f44329","name":"websocket_mcp","title":"WebSocket MCP","description":"Model Context Protocol (MCP) server and client with a custom websocket transport layer.","avatar_url":"https://avatars.githubusercontent.com/u/4321718?v=4","created_at":"$D2025-03-05T07:57:45.298Z","updated_at":"$D2025-03-12T10:18:24.516Z","status":"created","author_name":"zeropointo","author_avatar_url":"https://avatars.githubusercontent.com/u/4321718?v=4","tags":"websocket,mcp,model-context-protocol","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/zeropointo/websocket_mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-02-24 00:28:12\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools