schemas->forVersion( $revision ); * * @var \WP\McpSchema\Schemas * @see \WP\McpSchema\Schemas::forVersion() */ private Schemas $schemas; /** * Transport permission callback. * * @var callable|null */ private $transport_permission_callback; /** * Constructor. * * @param string $server_id Unique identifier for the server. * @param non-falsy-string $server_route_namespace Server route namespace. * @param non-falsy-string $server_route Server route. * @param string $server_name Human-readable server name. * @param string $server_description Server description. * @param string $server_version Server version. * @param array> $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 or MCP tools to register during construction. * @param list $resources Optional ability names or MCP resources to register during construction. * @param list $prompts Optional ability names, MCP prompts, or prompt builders 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; $this->schemas = Schemas::create(); // 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, $this->schemas ); // 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 non-falsy-string */ public function get_server_route_namespace(): string { return $this->server_route_namespace; } /** * Get server route. * * @return non-falsy-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. * * @param \WP\McpSchema\Schema $schema Selected exact schema. * @return array */ public function get_tools( Schema $schema ): array { return $this->component_registry->get_tools( $schema ); } /** * Get all resources registered to this server. * * @param \WP\McpSchema\Schema $schema Selected exact schema. * @return array */ public function get_resources( Schema $schema ): array { return $this->component_registry->get_resources( $schema ); } /** * Get all prompts registered to this server. * * @param \WP\McpSchema\Schema $schema Selected exact schema. * @return array */ public function get_prompts( Schema $schema ): array { return $this->component_registry->get_prompts( $schema ); } /** * Get the neutral registered tool count. * * @since 0.7.0 */ public function count_tools(): int { return $this->component_registry->count_tools(); } /** * Get the neutral registered resource count. * * @since 0.7.0 */ public function count_resources(): int { return $this->component_registry->count_resources(); } /** * Get the neutral registered prompt count. * * @since 0.7.0 */ public function count_prompts(): int { return $this->component_registry->count_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. * * @param \WP\McpSchema\Schema $schema Selected exact schema. * @return \WP\McpSchema\Record\Prompt|null */ public function get_prompt( string $prompt_name, Schema $schema ): ?Prompt { $mcp_prompt = $this->component_registry->get_mcp_prompt( $prompt_name ); if ( ! $mcp_prompt || ! $mcp_prompt->is_available_for( $schema ) ) { return null; } return $mcp_prompt->get_protocol_record( $schema ); } /** * 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(); } /** * Get the server-owned exact schemas. * * @since 0.7.0 */ public function get_schemas(): Schemas { return $this->schemas; } }