Hello World MCP Server

A simple Model Context Protocol (MCP) server that demonstrates the basic structure and functionality of an MCP server with a single greeting tool.

Features

• Single Tool: A greet tool that generates personalized greetings
• Multi-language Support: Supports English, Spanish, French, and German greetings
• TypeScript: Built with TypeScript for type safety
• NPX Ready: Can be run directly with npx

Installation

Global Installation

npm install -g hello-world-mcp-server

Run with NPX (without installation)

npx hello-world-mcp-server

Usage

This MCP server is designed to be used with MCP-compatible clients like Claude Desktop, Cline, or other MCP clients.

Tool Available

greet

Generates a personalized greeting message.

Parameters:

• name (required): The name of the person to greet
• language (optional): Language for the greeting (english, spanish, french, german). Defaults to english.

Example:

{
  "name": "greet",
  "arguments": {
    "name": "Alice",
    "language": "spanish"
  }
}

Response:

¡Hola, Alice! ¡Bienvenido al servidor MCP Hello World!

Development

Prerequisites

• Node.js 18 or higher
• npm

Setup

# Clone the repository
git clone <your-repo-url>
cd hello-world-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm start

Scripts

• npm run build: Compile TypeScript to JavaScript
• npm run watch: Watch for changes and rebuild automatically
• npm start: Run the compiled server
• npm run prepublishOnly: Build before publishing

Configuration for MCP Clients

Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "hello-world": {
      "command": "npx",
      "args": ["hello-world-mcp-server"]
    }
  }
}

VS Code with MCP Extension

Add this to your MCP configuration:

{
  "servers": {
    "hello-world": {
      "type": "stdio",
      "command": "npx",
      "args": ["hello-world-mcp-server"]
    }
  }
}

Publishing to NPM

1. Make sure you're logged in to npm:

   npm login

2. Update the version (if needed):

   npm version patch  # or minor, major

3. Publish:

   npm publish

License

MIT