Hello World MCP Server

What is Hello World MCP Server?

Hello World MCP Server is a demonstration server built with the Model Context Protocol (MCP) SDK. It integrates Express for HTTP endpoints, supports server-sent events (SSE) and message communication, and registers tools and prompts. It is intended for developers learning to set up and test a basic MCP server.

How to use Hello World MCP Server?

Clone the repository, install dependencies with npm install, copy .env.example to .env and optionally change the PORT (default 4000). Build with npm run build, then start with npm start. For development with live reload, use npm run dev. Test using the MCP Inspector with npx @modelcontextprotocol/inspector ./dist/server.js.

Key features of Hello World MCP Server

• MCP SDK integration for tools and prompts
• Express framework handling SSE and messages
• Environment configuration via .env file
• Full TypeScript support
• Server-sent events (SSE) endpoints
• Tools and prompts registration in modular code

Use cases of Hello World MCP Server

• Learning how to set up an MCP server from scratch
• Testing MCP tools and prompts in a local environment
• Demonstrating SSE and message communication with Express
• Prototyping MCP‑based applications with a minimal codebase
• Debugging and inspecting server behavior using the MCP Inspector

FAQ from Hello World MCP Server

What is the purpose of Hello World MCP Server?

It is a reference implementation that shows how to create an MCP server with tools, prompts, SSE endpoints, and Express. It helps developers understand the basic structure and configuration.

How do I change the port the server runs on?

Edit the PORT variable in the .env file. The default port is 4000. If the port is already in use, update it and restart the server.

How can I test the server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector ./dist/server.js. This opens an interactive interface to test the registered tools and prompts.

What are the system requirements?

Node.js version 16 or higher and npm (or yarn) are required.

How do I run the server in development mode?

Use npm run dev to start the server with live reloading and detailed logs.