DefaultServerFactory.php
167 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Factory for creating the default WordPress MCP server. |
| 4 | * |
| 5 | * @package McpAdapter |
| 6 | */ |
| 7 | |
| 8 | declare( strict_types=1 ); |
| 9 | |
| 10 | namespace WP\MCP\Servers; |
| 11 | |
| 12 | use WP\MCP\Core\McpAdapter; |
| 13 | use WP\MCP\Infrastructure\ErrorHandling\ErrorLogMcpErrorHandler; |
| 14 | use WP\MCP\Infrastructure\Observability\NullMcpObservabilityHandler; |
| 15 | use WP\MCP\Transport\HttpTransport; |
| 16 | |
| 17 | /** |
| 18 | * Factory for creating the default WordPress MCP server. |
| 19 | * |
| 20 | * This server automatically discovers and exposes abilities with mcp.public=true metadata: |
| 21 | * - discover-abilities: Lists all publicly available WordPress abilities |
| 22 | * - get-ability-info: Gets detailed information about specific abilities |
| 23 | * - execute-ability: Executes WordPress abilities with provided parameters |
| 24 | */ |
| 25 | class DefaultServerFactory { |
| 26 | |
| 27 | /** |
| 28 | * Create default server for WordPress MCP Adapter with WordPress filters support. |
| 29 | * |
| 30 | * This method creates a server using WordPress-specific defaults and applies |
| 31 | * WordPress filters for customization, making it perfect for use within |
| 32 | * the McpAdapter. |
| 33 | * |
| 34 | * @return void |
| 35 | */ |
| 36 | public static function create(): void { |
| 37 | |
| 38 | // Auto-discover resources and prompts from abilities |
| 39 | $auto_discovered_resources = self::discover_abilities_by_type( 'resource' ); |
| 40 | $auto_discovered_prompts = self::discover_abilities_by_type( 'prompt' ); |
| 41 | |
| 42 | // WordPress-specific defaults |
| 43 | $wordpress_defaults = array( |
| 44 | 'server_id' => 'mcp-adapter-default-server', |
| 45 | 'server_route_namespace' => 'mcp', |
| 46 | 'server_route' => 'mcp-adapter-default-server', |
| 47 | 'server_name' => 'MCP Adapter Default Server', |
| 48 | 'server_description' => 'Default MCP server for WordPress abilities discovery and execution', |
| 49 | 'server_version' => 'v1.0.0', |
| 50 | 'mcp_transports' => array( HttpTransport::class ), |
| 51 | 'error_handler' => ErrorLogMcpErrorHandler::class, |
| 52 | 'observability_handler' => NullMcpObservabilityHandler::class, |
| 53 | 'tools' => array( |
| 54 | 'mcp-adapter/discover-abilities', |
| 55 | 'mcp-adapter/get-ability-info', |
| 56 | 'mcp-adapter/execute-ability', |
| 57 | ), |
| 58 | 'resources' => $auto_discovered_resources, |
| 59 | 'prompts' => $auto_discovered_prompts, |
| 60 | ); |
| 61 | |
| 62 | /** |
| 63 | * Filters the default MCP server configuration. |
| 64 | * |
| 65 | * Allows customization of the default server's settings before creation. |
| 66 | * The filtered array is merged with defaults, so you only need to specify |
| 67 | * the values you want to override. |
| 68 | * |
| 69 | * @since 0.3.0 |
| 70 | * |
| 71 | * @param array $config { |
| 72 | * Default server configuration. |
| 73 | * |
| 74 | * @type string $server_id Server identifier. Default 'mcp-adapter-default-server'. |
| 75 | * @type string $server_route_namespace REST API namespace. Default 'mcp-adapter/v1'. |
| 76 | * @type string $server_route REST API route. Default 'mcp'. |
| 77 | * @type string $server_name Human-readable name. Default 'WordPress MCP Server'. |
| 78 | * @type string $server_description Server description. |
| 79 | * @type string $server_version Server version. Default WORDPRESS_MCP_ADAPTER_VERSION. |
| 80 | * @type string[] $mcp_transports Transport class names. Default [HttpTransport::class]. |
| 81 | * @type string $error_handler Error handler class. Default ErrorLogMcpErrorHandler::class. |
| 82 | * @type string $observability_handler Observability handler class. Default NullMcpObservabilityHandler::class. |
| 83 | * @type string[] $tools Tool ability names to expose. |
| 84 | * @type string[] $resources Resource ability names to expose. |
| 85 | * @type string[] $prompts Prompt ability names to expose. |
| 86 | * } |
| 87 | */ |
| 88 | $config = apply_filters( 'mcp_adapter_default_server_config', $wordpress_defaults ); |
| 89 | |
| 90 | // Ensure config is an array and merge with defaults |
| 91 | if ( ! is_array( $config ) ) { |
| 92 | $config = $wordpress_defaults; |
| 93 | } |
| 94 | $config = wp_parse_args( $config, $wordpress_defaults ); |
| 95 | |
| 96 | // Use McpAdapter to create the server with full validation |
| 97 | $adapter = McpAdapter::instance(); |
| 98 | $result = $adapter->create_server( |
| 99 | $config['server_id'], |
| 100 | $config['server_route_namespace'], |
| 101 | $config['server_route'], |
| 102 | $config['server_name'], |
| 103 | $config['server_description'], |
| 104 | $config['server_version'], |
| 105 | $config['mcp_transports'], |
| 106 | $config['error_handler'], |
| 107 | $config['observability_handler'], |
| 108 | $config['tools'], |
| 109 | $config['resources'], |
| 110 | $config['prompts'] |
| 111 | ); |
| 112 | |
| 113 | // Log error if server creation failed, but don't halt execution. |
| 114 | // This allows other servers to be registered even if default server fails. |
| 115 | if ( ! is_wp_error( $result ) ) { |
| 116 | return; |
| 117 | } |
| 118 | |
| 119 | _doing_it_wrong( |
| 120 | __METHOD__, |
| 121 | sprintf( |
| 122 | 'MCP Adapter: Failed to create default server. Error: %s (Code: %s)', |
| 123 | esc_html( $result->get_error_message() ), |
| 124 | esc_html( (string) $result->get_error_code() ) |
| 125 | ), |
| 126 | '0.5.0' |
| 127 | ); |
| 128 | } |
| 129 | |
| 130 | /** |
| 131 | * Discover abilities by MCP type. |
| 132 | * |
| 133 | * Scans all registered abilities and returns those with the specified type |
| 134 | * and public MCP exposure. |
| 135 | * |
| 136 | * @param string $type The MCP type to filter by ('tool', 'resource', or 'prompt'). |
| 137 | * |
| 138 | * @return array Array of ability names matching the specified type. |
| 139 | */ |
| 140 | private static function discover_abilities_by_type( string $type ): array { |
| 141 | $abilities = wp_get_abilities(); |
| 142 | $filtered = array(); |
| 143 | |
| 144 | foreach ( $abilities as $ability ) { |
| 145 | $ability_name = $ability->get_name(); |
| 146 | $meta = $ability->get_meta(); |
| 147 | |
| 148 | // Skip if not publicly exposed |
| 149 | if ( ! ( $meta['mcp']['public'] ?? false ) ) { |
| 150 | continue; |
| 151 | } |
| 152 | |
| 153 | // Get the type (defaults to 'tool' if not specified) |
| 154 | $ability_type = $meta['mcp']['type'] ?? 'tool'; |
| 155 | |
| 156 | // Add to filtered list if type matches |
| 157 | if ( $ability_type !== $type ) { |
| 158 | continue; |
| 159 | } |
| 160 | |
| 161 | $filtered[] = $ability_name; |
| 162 | } |
| 163 | |
| 164 | return $filtered; |
| 165 | } |
| 166 | } |
| 167 |