mcp-server-demo

elvisleyva49/mcp-server-demo

3.2

If you are the rightful owner of mcp-server-demo and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A minimal MCP server implementation using WebSocket, ideal for modern integrations with tools like VSCode, Claude, etc.

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.