> $mcp_transports Array of MCP transport class names to initialize (e.g., [McpRestTransport::class]). * @param class-string<\WP\MCP\Infrastructure\ErrorHandling\Contracts\McpErrorHandlerInterface>|null $error_handler Error handler class to use (e.g., NullMcpErrorHandler::class). Must implement McpErrorHandlerInterface. If null, NullMcpErrorHandler will be used. * @param class-string<\WP\MCP\Infrastructure\Observability\Contracts\McpObservabilityHandlerInterface>|null $observability_handler Observability handler class to use (e.g., NullMcpObservabilityHandler::class). Must implement McpObservabilityHandlerInterface. If null, NullMcpObservabilityHandler will be used. * @param list $tools Optional ability names to register as tools during construction. * @param list $resources Optional resources to register during construction. * @param list $prompts Optional prompts to register during construction. * @param callable|null $transport_permission_callback Optional custom permission callback for transport-level authentication. If null, defaults to is_user_logged_in(). * * @throws \Exception Thrown if the MCP transport class does not extend AbstractMcpTransport. */ public function __construct( string $server_id, string $server_route_namespace, string $server_route, string $server_name, string $server_description, string $server_version, array $mcp_transports, ?string $error_handler, ?string $observability_handler, array $tools = array(), array $resources = array(), array $prompts = array(), ?callable $transport_permission_callback = null ) { // Store server configuration $this->server_id = $server_id; $this->server_route_namespace = $server_route_namespace; $this->server_route = $server_route; $this->server_name = $server_name; $this->server_description = $server_description; $this->server_version = $server_version; $this->transport_permission_callback = $transport_permission_callback; /** * Filters whether MCP protocol validation is enabled for a server. * * Validation is disabled by default for performance, as the Abilities API * also validates all abilities. Enable this filter for stricter MCP protocol * compliance checking during development or debugging. * * @since 0.3.0 * * @param bool $enabled Whether validation is enabled. Default false. * @param string $server_id The server ID being configured. * @param \WP\MCP\Core\McpServer $server The McpServer instance being constructed. */ $this->mcp_validation_enabled = apply_filters( 'mcp_adapter_validation_enabled', false, $this->server_id, $this ); // Setup handlers and components $this->setup_handlers( $error_handler, $observability_handler ); $this->setup_components( $tools, $resources, $prompts, $mcp_transports ); } /** * Setup error and observability handlers. * * @param string|null $error_handler Error handler class name. * @param string|null $observability_handler Observability handler class name. */ private function setup_handlers( ?string $error_handler, ?string $observability_handler ): void { // Instantiate error handler if ( $error_handler && class_exists( $error_handler ) ) { /** @var \WP\MCP\Infrastructure\ErrorHandling\Contracts\McpErrorHandlerInterface $handler */ $handler = new $error_handler(); $this->error_handler = $handler; } else { $this->error_handler = new NullMcpErrorHandler(); } // Instantiate observability handler if ( $observability_handler && class_exists( $observability_handler ) ) { /** @var \WP\MCP\Infrastructure\Observability\Contracts\McpObservabilityHandlerInterface $handler */ $handler = new $observability_handler(); $this->observability_handler = $handler; } else { $this->observability_handler = new NullMcpObservabilityHandler(); } } /** * Setup component registry and transport factory. * * @param list $tools Tools to register. * @param list $resources Resources to register. * @param list $prompts Prompts to register. * @param array> $mcp_transports Transport classes to initialize. * * @throws \Exception */ private function setup_components( array $tools, array $resources, array $prompts, array $mcp_transports ): void { // Initialize component registry $this->component_registry = new McpComponentRegistry( $this, $this->error_handler, $this->observability_handler ); // Initialize transport factory $this->transport_factory = new McpTransportFactory( $this ); // Register tools, resources, and prompts $this->register_mcp_components( $tools, $resources, $prompts ); // Initialize transports $this->transport_factory->initialize_transports( $mcp_transports ); } /** * Register initial tools, resources, and prompts. * * @param list $tools Tools to register. * @param list $resources Resources to register. * @param list $prompts Prompts to register. */ private function register_mcp_components( array $tools, array $resources, array $prompts ): void { // Register tools if provided if ( ! empty( $tools ) ) { $this->component_registry->register_tools( $tools ); } // Register resources if provided if ( ! empty( $resources ) ) { $this->component_registry->register_resources( $resources ); } // Register prompts if provided if ( empty( $prompts ) ) { return; } $this->component_registry->register_prompts( $prompts ); } /** * Get server ID. * * @return string */ public function get_server_id(): string { return $this->server_id; } /** * Get server route namespace. * * @return string */ public function get_server_route_namespace(): string { return $this->server_route_namespace; } /** * Get server route. * * @return string */ public function get_server_route(): string { return $this->server_route; } /** * Get the server name. * * @return string */ public function get_server_name(): string { return $this->server_name; } /** * Get server description. * * @return string */ public function get_server_description(): string { return $this->server_description; } /** * Get server version. * * @return string */ public function get_server_version(): string { return $this->server_version; } /** * Get the transport permission callback. * * @return callable|null */ public function get_transport_permission_callback(): ?callable { return $this->transport_permission_callback; } /** * Get the observability handler instance. * * @return \WP\MCP\Infrastructure\Observability\Contracts\McpObservabilityHandlerInterface */ public function get_observability_handler(): McpObservabilityHandlerInterface { return $this->observability_handler; } /** * Get the error handler instance. * * @since 0.5.0 * * @return \WP\MCP\Infrastructure\ErrorHandling\Contracts\McpErrorHandlerInterface */ public function get_error_handler(): McpErrorHandlerInterface { return $this->error_handler; } /** * Get all tools registered to this server. * * @return array */ public function get_tools(): array { return $this->component_registry->get_tools(); } /** * Get all resources registered to this server. * * @return array */ public function get_resources(): array { return $this->component_registry->get_resources(); } /** * Get all prompts registered to this server. * * @return array */ public function get_prompts(): array { return $this->component_registry->get_prompts(); } /** * Get a specific McpTool by name. * * @param string $tool_name Tool name. * * @return \WP\MCP\Domain\Tools\McpTool|null * @internal * @since 0.3.0 * */ public function get_mcp_tool( string $tool_name ): ?McpTool { return $this->component_registry->get_mcp_tool( $tool_name ); } /** * Get a specific McpResource by URI. * * @param string $resource_uri Resource URI. * * @return \WP\MCP\Domain\Resources\McpResource|null * @internal * @since 0.3.0 * */ public function get_mcp_resource( string $resource_uri ): ?McpResource { return $this->component_registry->get_mcp_resource( $resource_uri ); } /** * Get a specific prompt by name. * * @param string $prompt_name Prompt name. * * @return \WP\McpSchema\Server\Prompts\DTO\Prompt|null */ public function get_prompt( string $prompt_name ): ?PromptDto { $mcp_prompt = $this->component_registry->get_mcp_prompt( $prompt_name ); return $mcp_prompt ? $mcp_prompt->get_protocol_dto() : null; } /** * Get an McpPrompt by name. * * @param string $prompt_name Prompt name. * * @return \WP\MCP\Domain\Prompts\McpPrompt|null * @internal * @since 0.3.0 * */ public function get_mcp_prompt( string $prompt_name ): ?McpPrompt { return $this->component_registry->get_mcp_prompt( $prompt_name ); } /** * Get a prompt builder instance by prompt name (builder-based prompts). * * @param string $prompt_name Prompt name. * * @return \WP\MCP\Domain\Prompts\Contracts\McpPromptBuilderInterface|null */ public function get_prompt_builder( string $prompt_name ): ?McpPromptBuilderInterface { return $this->component_registry->get_prompt_builder( $prompt_name ); } /** * Create transport context with all required dependencies. * * @return \WP\MCP\Transport\Infrastructure\McpTransportContext */ public function create_transport_context(): McpTransportContext { return $this->transport_factory->create_transport_context(); } /** * Check if MCP validation is enabled. * * @return bool */ public function is_mcp_validation_enabled(): bool { return $this->mcp_validation_enabled; } }