attribute-based mcp element discovery and registration
Automatically discovers and registers MCP elements (Tools, Resources, Prompts, Resource Templates) by scanning the filesystem for PHP classes annotated with #[McpTool], #[McpResource], #[McpResourceTemplate], and #[McpPrompt] attributes. The Discoverer component uses reflection to parse these attributes and automatically register handlers without manual configuration, enabling zero-boilerplate exposure of application functionality to AI assistants.
Unique: Uses PHP 8.1+ attributes combined with filesystem scanning and reflection to enable declarative, zero-boilerplate registration of MCP elements. The Discoverer component automatically parses method signatures and docblocks to generate JSON schemas without manual schema definition, eliminating the need for separate schema files or registration code.
vs alternatives: Faster developer iteration than manual registration approaches because attributes co-locate element definition with implementation, reducing context switching and configuration drift.
automatic json schema generation from method signatures and docblocks
Generates JSON Schema 2020-12 compliant schemas automatically by parsing PHP method signatures, type hints, and docblock annotations using reflection and docblock parsing. This eliminates manual schema definition while supporting complex types (unions, generics, nullable types) and docstring-based parameter descriptions, enabling AI clients to understand tool capabilities without separate schema files.
Unique: Combines PHP reflection API with docblock parsing to generate complete JSON schemas from method signatures without requiring separate schema definitions. Supports modern PHP type system features (union types, named arguments, typed properties) and automatically extracts parameter descriptions from docblocks, creating self-documenting MCP elements.
vs alternatives: Eliminates schema maintenance burden compared to frameworks requiring manual schema definition, because schema is derived directly from code and stays synchronized automatically.
json-rpc 2.0 protocol implementation with request/response handling
Implements the JSON-RPC 2.0 specification for message exchange between client and server. The Protocol component parses incoming JSON-RPC requests, routes them to appropriate handlers through the Dispatcher, and formats responses according to JSON-RPC 2.0 spec (including error responses with error codes and messages). Supports both request/response and notification patterns, enabling bidirectional communication between MCP clients and servers.
Unique: Implements complete JSON-RPC 2.0 protocol handling including request parsing, routing, response formatting, and error responses with standardized error codes. Supports both request/response and notification patterns, enabling the same Protocol component to handle all JSON-RPC message types across different transports.
vs alternatives: More standards-compliant than custom RPC implementations because it strictly follows JSON-RPC 2.0 specification, ensuring compatibility with any JSON-RPC 2.0 client without custom protocol negotiation.
fluent serverbuilder configuration interface
Provides a fluent, chainable API for configuring the MCP server through the ServerBuilder class. Developers use method chaining to register transports, set up dependency injection, configure caching, enable session management, and register MCP elements. The builder pattern enables readable, self-documenting server configuration that can be version-controlled and easily modified without touching core server logic.
Unique: Implements fluent builder pattern for server configuration, enabling readable method chaining for setting up transports, DI containers, caching, sessions, and element discovery. The builder accumulates configuration and creates a fully-initialized Server instance, making configuration self-documenting and easy to modify.
vs alternatives: More readable than array-based configuration because method chaining makes configuration intent explicit and enables IDE autocomplete, reducing configuration errors and improving maintainability.
streaming http transport with resumability and event sourcing
Implements StreamableHttpServerTransport for production deployments, supporting resumable connections and event sourcing patterns. Clients can reconnect and resume interrupted streams without losing messages, and the server can emit events as Server-Sent Events (SSE) or streaming JSON responses. This transport is recommended over deprecated HttpServerTransport for new projects requiring reliable message delivery and connection resilience.
Unique: Implements resumable HTTP streaming with event sourcing, allowing clients to reconnect and resume interrupted streams without losing messages. Supports both Server-Sent Events and streaming JSON response modes, providing flexibility for different client implementations while maintaining reliable message delivery.
vs alternatives: More resilient than deprecated HttpServerTransport because it supports connection resumption and event sourcing, enabling clients to recover from network interruptions without losing messages or requiring full reconnection.
transport-agnostic request handling with multiple protocol implementations
Abstracts network communication through pluggable transport implementations (StdioServerTransport, HttpServerTransport, StreamableHttpServerTransport) that all conform to a common interface. The Protocol component handles JSON-RPC 2.0 message parsing and routing independently of transport, allowing the same server logic to operate over STDIO, HTTP+SSE, or streaming HTTP without code changes.
Unique: Implements transport abstraction through a common interface that decouples Protocol (JSON-RPC 2.0 handling) from network communication. Built on ReactPHP for non-blocking I/O, enabling high-concurrency HTTP handling while maintaining identical server logic across STDIO, HTTP+SSE, and streaming HTTP transports.
vs alternatives: More flexible than single-transport implementations because the same server code runs unchanged over STDIO for CLI tools, HTTP for web integration, and streaming HTTP for production deployments with resumability and event sourcing.
psr-11 dependency injection with automatic handler resolution
Integrates with PSR-11 Container interface to enable dependency injection for MCP element handlers. The ServerBuilder and Dispatcher automatically resolve handler dependencies from the container, allowing handlers to declare constructor dependencies that are automatically injected without manual wiring. Supports both explicit container configuration and automatic resolution of registered services.
Unique: Implements automatic handler resolution through PSR-11 Container integration, allowing handlers to declare constructor dependencies that are automatically injected by the Dispatcher. This eliminates manual service instantiation in handler code and enables seamless integration with existing PHP framework containers.
vs alternatives: Integrates more naturally with existing PHP ecosystems than frameworks requiring custom service registries, because it uses the standard PSR-11 interface that Laravel, Symfony, and other major frameworks already support.
multi-backend session management with persistence and garbage collection
Provides SessionManager component supporting multiple storage backends (in-memory, file-based, Redis, database) for maintaining client session state across requests. Implements automatic garbage collection of expired sessions and supports configurable TTL per session, enabling stateful MCP interactions where clients can maintain context across multiple tool invocations without re-sending full context.
Unique: Implements pluggable session backends with automatic garbage collection, allowing the same SessionManager code to work with in-memory, file, Redis, or database storage. Supports configurable TTL per session and automatic cleanup of expired sessions, enabling stateful MCP interactions without manual session lifecycle management.
vs alternatives: More flexible than single-backend session implementations because it supports multiple storage backends through a common interface, allowing developers to choose persistence strategy (in-memory for development, Redis for production) without code changes.
+5 more capabilities