mcp-hello-world

Provides a minimal reference implementation for bootstrapping a Model Context Protocol server with standard lifecycle hooks (startup, shutdown, request handling). Uses the MCP SDK to establish bidirectional communication channels between client and server, handling protocol negotiation, message routing, and graceful shutdown. The hello-world pattern demonstrates the foundational server setup that all MCP implementations must follow.

Enables declaring tools with structured schemas (name, description, input parameters) and exposing them through the MCP tools/list and tools/call endpoints. The implementation uses JSON Schema to define tool signatures, allowing clients to discover available tools and invoke them with type-safe parameters. This follows the MCP specification for tool exposure and enables Claude or other clients to understand and call custom functionality.

Implements the core MCP message dispatch loop that routes incoming JSON-RPC 2.0 requests to appropriate handler functions based on method name. Uses event-driven patterns to attach handlers for specific MCP methods (e.g., 'tools/list', 'tools/call') and automatically serializes responses back to JSON-RPC format. The routing layer abstracts protocol details from business logic, allowing developers to focus on handler implementation.

Establishes persistent bidirectional communication channels between MCP client and server using stdio or network transports. Handles connection lifecycle (initialization, heartbeat/keep-alive if needed, graceful closure) and ensures both client and server can initiate messages. The transport abstraction allows the same server code to work over stdio (for local integration), HTTP, or other protocols without code changes.

Ensures the server implementation follows the Model Context Protocol specification, including proper message formatting, required fields, error handling conventions, and capability negotiation. The hello-world template demonstrates correct protocol usage patterns that clients can rely on, serving as a reference for what compliant MCP servers should look like. This includes proper handling of protocol versions, required metadata, and standard response formats.

Packages the MCP server as an npm module with proper package.json configuration, entry points, and dependency declarations. Enables developers to install the hello-world template as a starting point via 'npm install @lobehub/mcp-hello-world' or use it as a reference. The package includes build scripts, TypeScript definitions (if applicable), and proper export configuration for both CommonJS and ES modules.