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

git clone https://github.com/tuusuario/mcp-server-demo.git
cd mcp-server-demo
npm install

2. Run the server

npm start

Server runs at ws://localhost:4000.

3. Test with the example client

npm run client

You should see connection logs and message exchange.

📁 Project Structure

• index.js: Main server (Express + WebSocket)
• mcp-protocol.js: MCP message validation logic
• clients/example-client.js: Example WebSocket client
• Dockerfile: For cloud deployment
• package.json: Dependencies and scripts

🐳 Deploy to Google Cloud Run

1. Build and push the Docker image
2. Deploy using the suggested gcloud run deploy commands

📝 References

See the accompanying article for theoretical context and use cases.

Made with ❤️ for educational purposes.