MCP Hello World - MCP Server Mock for Testing

Name: MCP Hello World - MCP Server Mock for Testing
Author: lobehub

@lobehub

Repository

About MCP Hello World - MCP Server Mock for Testing

A simple Hello World MCP server for CI/CD test

Basic information

Config

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

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

Tools

Echoes the input message, prefixed with "Hello ".

Lists all available MCP method definitions on the server.

Overview

What is MCP Hello World - MCP Server Mock for Testing?

A minimal Model Context Protocol (MCP) server implemented in TypeScript, designed as a Test Double or Mock Server for unit and integration testing of MCP client code. It provides a lightweight, controllable, and predictable test environment.

How to use MCP Hello World - MCP Server Mock for Testing?

Install as a dev dependency (pnpm add --save-dev mcp-hello-world or bun add --dev mcp-hello-world). Run manually in STDIO mode (npx mcp-hello-world) or HTTP/SSE mode (build then pnpm start:http). Programmatically start and stop the server within test frameworks like Jest or Vitest.

Key features of MCP Hello World - MCP Server Mock for Testing

Minimal MCP server mock for testing
Supports both STDIO and HTTP/SSE transport protocols
Provides echo and debug tools with fixed behaviors
Offers static and dynamic greeting resources
Fast startup and lightweight dependencies

Use cases of MCP Hello World - MCP Server Mock for Testing

Unit testing MCP client code in isolation
Integration testing client behavior over STDIO or HTTP/SSE
Debugging MCP client interactions with a predictable server

FAQ from MCP Hello World - MCP Server Mock for Testing

Is this server suitable for production use?

No, it is explicitly not suitable for production environments or general-purpose deployment.

What transport protocols does it support?

It supports both STDIO and HTTP/SSE MCP transport protocols.

What resources and tools does the server provide?

It provides resources (hello://world, greeting://{name}), tools (echo, debug), and a prompt (helpful-assistant).

What are the runtime requirements?

The server requires Node.js and is installed via npm/pnpm/bun as a TypeScript package.

Does it support programmatic control in tests?

Yes, it can be programmatically started and stopped within test frameworks (Jest, Vitest, Mocha) using spawn for STDIO or HTTP modes.

Comments

More Developer Tools MCP servers

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K