mcp-hello-world

mcp-hello-world

7

MCP Hello World is a minimal MCP server for testing client code that interacts with an MCP server. It provides a predictable and controllable environment for unit and integration testing, supporting both STDIO and HTTP/SSE protocols. It is lightweight and not intended for production use.

MCP Hello World - MCP Server Mock for Testing

This project is a minimal Model Context Protocol (MCP) server implemented in TypeScript, primarily intended as a test double or mock server for testing purposes. It is designed to provide a lightweight, controllable, and predictable environment for unit testing or integration testing of client code interacting with an MCP server. It supports both STDIO and HTTP/SSE transport protocols.

Why Use mcp-hello-world in Tests?

  • Isolation: Focus on client logic without external server issues.
  • Predictability: Simple, fixed behaviors for easy assertions.
  • Speed: Fast startup and response times.
  • Lightweight: Few dependencies for easy integration.
  • Protocol Coverage: Supports STDIO and HTTP/SSE MCP transport protocols.

Usage in Tests

mcp-hello-world can be programmatically started and stopped within test frameworks for automated testing.

Provided MCP Capabilities

  • Resources: Static and dynamic resources for interaction.
  • Tools: Echo and debug tools for assertions.
  • Prompts: A helpful assistant prompt for predefined roles.

License

MIT