# 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.