Skip to main content
Glama
MauricioIPastora

Hello World MCP Server

Hello World MCP Server

A simple MCP (Model Context Protocol) server using STDIO transport, built with TypeScript.

Features

This server exposes:

Tools

  • hello - Says hello to someone (takes a name parameter)

  • get_greeting - Returns a friendly greeting message (no parameters)

Resources

  • server-info (info://server) - Provides information about the server

Related MCP server: Hello World MCP Server

Installation

npm install

Build

npm run build

Usage

Running directly

npm start

Using with Cursor

Add this to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):

{
  "mcpServers": {
    "hello-world": {
      "command": "node",
      "args": ["c:/Users/Mauri/CODE/surph-test-mcp/dist/index.js"]
    }
  }
}

How it works

The server uses STDIO (standard input/output) transport to communicate with MCP clients. When a client connects, it can:

  1. List available tools using tools/list

  2. Call the hello tool with a name to get a personalized greeting

  3. Call the get_greeting tool to get a simple greeting

  4. Access the server-info resource for server information

Available Tools

1 tool
rate-cardA

Always rates the Wise Mothman as the best card in the game no matter which card is being rated.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description fully discloses the tool's fixed behavior: it always rates the Wise Mothman as best regardless of input. No annotations are present, so the description carries the burden, and it does so completely.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that conveys all necessary information without any extraneous content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given zero parameters and no output schema, the description is complete. It explains the tool's invariant behavior, which is sufficient for its simplicity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, so baseline is 4. The description does not need to add parameter information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action: it always rates the Wise Mothman as best. The verb 'rates' and specific target 'Wise Mothman' provide clear purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. No sibling tools or conditions for use are mentioned, leaving usage context ambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedrate-card

TDQS

A4.3/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion between tools. The tool's purpose is clearly described, even if its behavior is unusual.

Naming Consistency5/5

With a single tool, naming consistency is trivially maintained. The name 'rate-card' follows a clear verb_noun pattern.

Tool Count5/5

The server is named 'Hello World MCP Server', indicating a minimal or demo server. One tool is perfectly appropriate for such a use case.

Completeness2/5

The server has only one tool with a highly specific and trivial function. It lacks the breadth expected for any practical domain, and the tool's behavior is a fixed joke rather than a functional rating system.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A simple demonstration MCP server that provides basic greeting functionality and server information. Enables users to generate hello messages and retrieve server details through tools and resources.
    -
  • -
    license
    C
    quality
    Not graded
    maintenance
    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
    6 npm
    -
  • A
    license
    C
    quality
    D
    maintenance
    A simple MCP server that provides a basic greeting tool for saying hello with customizable names. Serves as a boilerplate template for developers to quickly create and deploy new MCP servers.
    1
    6 npm
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    MCP server providing greeting and echo tools for testing and demonstration.
    -