MCP Hello World - MCP Server Mock for Testing
@lobehub
A simple Hello World MCP server for CI/CD test
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.
