How eduardocruz/mcp-php-sdk works
This repository is an MCP server SDK: an application registers resources, tools, and prompts, connects the server to a transport, and serves JSON-RPC requests from an MCP client. The facade coordinates domain managers and protocol handling; stdio is the documented transport. The graph also captures protocol errors, notifications, cancellation, and logging. Some implementation excerpts are incomplete, so links for documented but unsampled domain behavior rely on the README or SOURCE INDEX references rather than implying inspection of omitted code.
Main entry points: Server.php Request dispatcher · McpServer.php MCP server facade · NotificationManager.php Notification delivery · StdioTransport.php stdio transport
Components 24
Server and capabilities
- MCP server facade
src/Server/McpServer.php - Request dispatcher
src/Server/Server.php
MCP domains
- Resource management
src/Protocol/Resources/ResourceManager.php - Resource types
src/Protocol/Resources/Resource.php - URI templates
src/Protocol/Resources/UriTemplate.php - Tool management
src/Server/Tools/ToolManager.php - Tool validation
src/Server/Tools/Schema/Validator.php - Prompt management
src/Server/Prompts/PromptManager.php - Prompt execution
src/Server/Prompts/Prompt.php - Prompt schema
src/Server/Prompts/Schema/PromptSchema.php
Protocol handling
- JSON-RPC requests
src/Protocol/Messages/Request.php - JSON-RPC notifications
src/Protocol/Messages/Notification.php - Error responses
src/Protocol/Errors/ErrorResponseBuilder.php - Error recovery
src/Protocol/Errors/ErrorRecovery.php - Notification delivery
src/Protocol/Notifications/NotificationManager.php
Transport and operations
- Transport contract
src/Transport/TransportInterface.php - stdio transport
src/Transport/StdioTransport.php - Message framing
src/Transport/MessageBuffer.php - Request cancellation
src/Utilities/Cancellation/CancellationManager.php - Cancellation token
src/Utilities/Cancellation/CancellationToken.php - Health monitoring
src/Utilities/HealthMonitor.php - Console logging
src/Utilities/Logging/ConsoleLogger.php
Other components
- MCP client
- Host application
Connections 27
- Host application → MCP server facade: registers capabilities
README.md - Host application → stdio transport: connects transport
README.md - MCP client → stdio transport: exchanges messages
README.md - stdio transport → Message framing: frames messages
src/Transport/StdioTransport.php - stdio transport → Request dispatcher: dispatches messages
src/Transport/StdioTransport.php - MCP server facade → Request dispatcher: configures server
src/Server/McpServer.php - MCP server facade → Resource management: registers resources
src/Server/McpServer.php - MCP server facade → Tool management: registers tools
src/Server/McpServer.php - MCP server facade → Prompt management: registers prompts
src/Server/McpServer.php - Request dispatcher → JSON-RPC requests: handles requests
src/Server/Server.php - Request dispatcher → Error responses: builds errors
src/Server/Server.php - Request dispatcher → Request cancellation: tracks cancellation
src/Server/Server.php - Request dispatcher → Notification delivery: sends notifications
src/Server/Server.php - Resource management → Resource types: manages resources
src/Protocol/Resources/ResourceManager.php - Resource types → URI templates: matches templates
src/Protocol/Resources/Resource.php - Tool management → Tool validation: validates arguments
src/Server/Tools/ToolManager.php - Prompt management → Prompt execution: executes prompts
src/Server/Prompts/PromptManager.php - Prompt management → Prompt schema: validates prompt schema
src/Server/Prompts/PromptManager.php - Prompt management → Notification delivery: announces changes
src/Server/Prompts/PromptManager.php - Notification delivery → JSON-RPC notifications: queues notifications
src/Protocol/Notifications/NotificationManager.php - Notification delivery → Transport contract: delivers notifications
src/Protocol/Notifications/NotificationManager.php - Request cancellation → Cancellation token: manages tokens
src/Utilities/Cancellation/CancellationManager.php - Request dispatcher → Health monitoring: monitors requests
src/Server/Server.php - Error recovery → Error responses: builds error responses
src/Protocol/Errors/ErrorRecovery.php - stdio transport → Console logging: logs transport events
src/Transport/StdioTransport.php - Notification delivery → Console logging: logs delivery
src/Protocol/Notifications/NotificationManager.php - Request cancellation → Console logging: logs cancellation
src/Utilities/Cancellation/CancellationManager.php