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
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server Demoshow me the available tools and their descriptions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: claude-code-mcp
📁 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 deploycommands
📝 References
See the accompanying article for theoretical context and use cases.
Made with ❤️ for educational purposes.