Hello World MCP Server

A simple TypeScript implementation of a Model Context Protocol (MCP) server with resources, prompts, and tools. This starter project demonstrates MCP fundamentals and serves as a template for building more complex MCP servers.

Features

• Static Resource: Provides a "Hello, World" message when called via hello://world
• Dynamic Resource: Customizable greeting that accepts a name parameter via greeting://{name}
• Prompt: Simple prompt that configures an assistant with "You are a helpful assistant"
• Tool: Echo tool that returns "Hello" plus your input message
• Multiple Transport Options: Run as either a stdio server or HTTP server with Server-Sent Events (SSE)

Installation

npm install

Build

npm run build

Clean

npm run clean

Run

Using STDIO (for integration with Claude Desktop)

npm run start

Using HTTP with SSE (for web clients)

npm run start:http

By default, the HTTP server runs on port 3000. You can change this by setting the PORT environment variable.

Project Structure

.
├── scripts/        # Helper scripts
├── src/            # Source code
│   ├── http.ts     # HTTP transport implementation
│   ├── index.ts    # Main entry point 
│   ├── server.ts   # MCP server configuration
│   └── stdio.ts    # STDIO transport implementation
├── package.json    # Project dependencies and scripts
└── tsconfig.json   # TypeScript configuration

Technical Details

• Built with TypeScript and the @modelcontextprotocol/sdk (v1.7.0+)
• Uses Zod for type validation in tools
• HTTP server implemented with Express.js
• Supports Server-Sent Events (SSE) for real-time communication

Using the Server

You can connect to this server using any MCP client, such as Claude Desktop, or build your own client.

Claude Desktop Configuration

To use this server with Claude Desktop, add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "hello-world": {
      "command": "node",
      "args": ["<path-to-repo>/build/stdio.js"]
    }
  }
}

HTTP/SSE Client Integration

{
  "mcpServers": {
    "hello-world": {
      "type": "sse",
      "url": "http://localhost:3001/sse",
      "messageEndpoint": "http://localhost:3001/messages",
      "timeout": 30000,  // 连接超时时间（毫秒），默认30秒
      "reconnect": true,  // SSE 断线自动重连
      "reconnectInterval": 5000,  // 重连间隔（毫秒）
      "maxReconnectAttempts": 5  // 最大重连次数
    }
  }
}

When running in HTTP mode:

1. Connect to the SSE endpoint at /sse to establish a connection
2. Send messages to the /messages endpoint via POST requests
3. Receive responses through the SSE connection

Replace <path-to-repo> with the absolute path to this repository.