MCP Hello World - MCP Server Mock for Testing

@lobehub

About MCP Hello World - MCP Server Mock for Testing

A simple Hello World MCP server for CI/CD test

Basic information

Category

Developer Tools

License

MIT

Runtime

node

Transports

stdio

Publisher

lobehub

Config

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

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

Tools

2

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

test

A simple,high performance and secure live media server in pure Rust (RTMP[cluster]/RTSP/WebRTC[whip/whep]/HTTP-FLV/HLS).🦀

OpenSumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

MCP Unity Editor (Game Engine)

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

test

Go implementation of Ethereum proof of stake

FastAPI-MCP

Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!