@iflow-mcp/mcp-starter

Provides a pre-configured Node.js/TypeScript project template that implements the Model Context Protocol server specification, handling boilerplate setup for request/response routing, protocol versioning, and capability declaration. Uses a starter pattern to abstract away MCP protocol complexity, allowing developers to focus on implementing custom tools and resources rather than low-level protocol details.

Implements a declarative tool registry pattern where developers define tools using JSON Schema for input validation and type safety, then register them with the MCP server via a fluent API. The system automatically generates protocol-compliant tool descriptions, validates incoming requests against schemas, and routes calls to handler functions, eliminating manual protocol serialization.

Enables declaration of static and dynamic resources (files, API responses, computed data) that MCP clients can read or subscribe to via a resource URI scheme. Implements streaming support for large resources, allowing clients to consume data incrementally without loading entire payloads into memory, using MCP's streaming protocol for efficient data transfer.

Implements a JSON-RPC 2.0 request dispatcher that routes incoming MCP protocol messages to appropriate handlers based on method names, manages request/response correlation, and handles protocol-level errors (invalid requests, method not found, internal errors). Uses a middleware-style architecture to allow request/response interception for logging, authentication, or transformation.

Handles the MCP protocol initialization handshake where the server declares its capabilities (supported tools, resources, prompts) and protocol version to the client, then negotiates compatible protocol features. Implements version checking and graceful degradation for clients using older protocol versions, ensuring backward compatibility.

Implements comprehensive error handling that maps application errors to MCP-compliant error responses with proper error codes (invalid_request, method_not_found, invalid_params, internal_error), includes stack trace capture for debugging, and provides error recovery strategies. Ensures all error responses conform to JSON-RPC 2.0 specification.

Automatically generates TypeScript type definitions from JSON Schema tool input definitions, enabling compile-time type checking for tool handler functions and IDE autocomplete for tool arguments. Uses a schema-to-types compiler that produces strict types matching the schema constraints, reducing runtime type errors.

Provides a development mode that watches for file changes and automatically restarts the MCP server without manual intervention, includes built-in logging with configurable verbosity levels, and exposes a local debug endpoint for testing tools and resources. Enables rapid iteration during development with immediate feedback.

Provides a configuration system that loads settings from environment variables, .env files, and configuration objects, with type-safe access via a config object that validates required settings at startup. Supports environment-specific configurations (development, staging, production) with sensible defaults.