# 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
```bash
git clone https://github.com/tuusuario/mcp-server-demo.git
cd mcp-server-demo
npm install
```
### 2. Run the server
```bash
npm start
```
Server runs at `ws://localhost:4000`.
### 3. Test with the example client
```bash
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.
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/elvisleyva49/mcp-server-demo'
If you have feedback or need assistance with the MCP directory API, please join our Discord server