MCP.so
Sign In

Hello World MCP Server

@jageenshukla

Repository

About Hello World MCP Server

Demostrate simple mcp server with typescript.

Basic information

Category

Other

Runtime

node

Transports

stdio

Publisher

jageenshukla

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hello-world-mcp-server-jageenshukla": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "./dist/server.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K