Skip to main content
Glama

Hello World MCP Server

by Auxin-io
npmGitHub
JavaScript
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Hello World MCP Server

A simple Model Context Protocol (MCP) server that provides a hello world tool. This server serves as a boilerplate template to help developers quickly create and deploy new MCP servers. It demonstrates basic MCP server functionality with a greeting tool and can be easily modified to add custom tools and resources.

Features

  • Hello World Tool: Simple greeting tool that says "Hello, {name}" with default "world"

  • Input Validation: Uses Zod schemas for robust parameter validation

  • Simple and Clean: Minimal MCP server implementation for demonstration purposes

Using as a Boilerplate

This project serves as a starting template for building your own MCP servers. To create a custom MCP server:

  1. Clone or fork this repository

  2. Modify index.js to add your own tools using server.registerTool()

  3. Update package.json with your server name and description

  4. Customize the README and configuration files as needed

The basic structure includes proper error handling, input validation with Zod, and MCP protocol compliance.

Hello World Tool

The server provides a simple hello world tool that greets users with a customizable name.

Tool Usage

The helloWorld tool accepts an optional name parameter and returns a greeting message.

Parameters:

  • name: Name to greet (optional, defaults to "world")

Example Response:

Hello, world!

Installation

Global Installation (Recommended)

  1. Install globally via npm:

    npm install -g hello-world-mcp

  2. The hello-world-mcp command will be available system-wide

Local Installation

  1. Clone or download this repository

  2. Install dependencies:

    npm install

  3. Start the server:

    npm start

Usage

Starting the Server

npm start

MCP Configuration

For Global Installation

Add this to your MCP client configuration:

{ "mcpServers": { "hello-world-mcp": { "command": "hello-world-mcp", "args": [], "env": {}, "description": "Hello World MCP server with greeting tool" } } }

For Local Installation

Add this to your MCP client configuration:

{ "mcpServers": { "hello-world-mcp": { "command": "node", "args": ["index.js"], "cwd": "/path/to/hello-world-mcp", "env": {}, "description": "Hello World MCP server with greeting tool" } } }

Usage Examples

Hello World Tool

{ "name": "helloWorld", "arguments": { "name": "Alice" } }

Response:

{ "content": [ { "type": "text", "text": "Hello, Alice!" } ] }

Default Greeting

{ "name": "helloWorld", "arguments": {} }

Response:

{ "content": [ { "type": "text", "text": "Hello, world!" } ] }

Available Tools

Hello World Tool

helloWorld

A simple greeting tool that says "Hello, {name}" with default "world".

Parameters:

  • name: Name to greet (optional, defaults to "world")

Hello World Examples

Basic Greeting

{ "name": "helloWorld", "arguments": { "name": "Alice" } }

Response:

{ "content": [ { "type": "text", "text": "Hello, Alice!" } ] }

Default Greeting

{ "name": "helloWorld", "arguments": {} }

Response:

{ "content": [ { "type": "text", "text": "Hello, world!" } ] }

Response Format

The hello world tool returns a simple text response:

{ "content": [ { "type": "text", "text": "Hello, world!" } ] }

Dependencies

  • @modelcontextprotocol/sdk: MCP SDK for server implementation

  • zod: Schema validation library

License

ISC

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

A simple boilerplate MCP server that provides a basic greeting tool for demonstration purposes. Serves as a starting template for developers to quickly create and deploy custom MCP servers.

  1. Features
    1. Using as a Boilerplate
      1. Hello World Tool
        1. Tool Usage
      2. Installation
        1. Global Installation (Recommended)
        2. Local Installation
      3. Usage
        1. Starting the Server
        2. MCP Configuration
      4. Usage Examples
        1. Hello World Tool
        2. Default Greeting
      5. Available Tools
        1. Hello World Tool
        2. Hello World Examples
      6. Response Format
        1. Dependencies
          1. License

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Auxin-io/Demo-Not-Friendly-MCP'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server