MCP Demo 1 - Hello World

You have a lightweight MCP server implemented in Node.js and TypeScript that exposes real-time communication via SSE, handles MCP requests, and confirms health status. It’s ideal for learning MCP basics, testing client integrations, and prototyping server-side MCP workflows.

How to use

Start the server and connect with an MCP client to stream events, send requests, and observe responses. The server exposes an SSE endpoint for real-time updates, a POST endpoint to handle MCP requests, and a health check you can call to verify liveness. You will see a simple Hello World response to demonstrate MCP interactions.

How to install

Prerequisites you need on your machine are Node.js and npm. You will install dependencies, build the TypeScript project, and then run the server.

npm install

npm run build

npm start

Endpoints and behaviors

• GET /sse: Real-time SSE stream for MCP interactions. Open with a client capable of handling Server-Sent Events.
• POST /messages: Accepts MCP protocol requests and returns JSON-RPC styled responses.
• GET /health: Returns a simple health status to verify the server is running.

Sample run demonstrates a Hello World response delivered through MCP interactions. The server will indicate a successful hello message and greeting in the response payload.

Docker and run modes

If you want to containerize and run this server, you can create a Dockerfile to build and run the image. The container exposes port 3000 by default and starts with the standard start command.

FROM node:18-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

Available tools

sse_endpoint

SSE endpoint at /sse for real-time stream communication with MCP clients.

messages_endpoint

POST endpoint at /messages to process MCP requests and return results.

health_endpoint

Health check endpoint at /health to verify the server is up.

hello_world_response

Demo response showing a Hello World message and a greeting to MCP clients.