Uses Express as the web framework for hosting the MCP server
Allows cloning the repository from GitHub to set up the MCP server locally
Supports deployment to Google Cloud Run with provided Docker configuration and deployment commands
MCP Server Demo (WebSocket)
A minimal MCP server implementation using WebSocket, ideal for modern integrations with tools like VSCode, Claude, etc.
🚀 Quickstart
1. Clone and install
2. Run the server
Server runs at ws://localhost:4000
.
3. Test with the example client
You should see connection logs and message exchange.
📁 Project Structure
index.js
: Main server (Express + WebSocket)mcp-protocol.js
: MCP message validation logicclients/example-client.js
: Example WebSocket clientDockerfile
: For cloud deploymentpackage.json
: Dependencies and scripts
🐳 Deploy to Google Cloud Run
- Build and push the Docker image
- Deploy using the suggested
gcloud run deploy
commands
📝 References
See the accompanying article for theoretical context and use cases.
Made with ❤️ for educational purposes.
This server cannot be installed
A minimal WebSocket-based MCP server implementation that enables modern tool integrations with VSCode, Claude, and other applications.
Related MCP Servers
- AsecurityAlicenseAqualityTypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.Last updated -313MIT License
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -484TypeScript
- AsecurityAlicenseAqualityThis project aims to build a Claude Code MCP server and implement its associated tools (explain\_code, review\_code, fix\_code, edit\_code, test\_code, simulate\_command, your\_own\_query). The server is implemented using Node.js and the MCP SDK. It receives tool requests from clients via Stdio, dynamicallyLast updated -710521JavaScriptMIT License
- -security-license-qualityAn MCP server that enables Claude and other MCP clients to interact with Mattermost workspaces, providing channel management, messaging capabilities, and topic monitoring functionality.Last updated -TypeScript