] * : The ID of the MCP server to serve. If not specified, uses the first available server. * * [--user=] * : Run as a specific WordPress user for permission checks. * : Without this, runs as unauthenticated (limited capabilities). * * ## EXAMPLES * * # Serve the default MCP server as admin user * wp mcp serve --user=admin * * # Serve a specific server as user with ID 1 * wp mcp serve --server=my-mcp-server --user=1 * * # Serve without authentication (limited capabilities) * wp mcp serve --server=public-server * * @when after_wp_load * @synopsis [--server=] [--user=] */ public function serve( array $args, array $assoc_args ): void { // Get the MCP adapter instance $adapter = McpAdapter::instance(); // Get all registered servers $servers = $adapter->get_servers(); if ( empty( $servers ) ) { \WP_CLI::error( 'No MCP servers are registered. Please register at least one server first.' ); } // Determine which server to use $server_id = $assoc_args['server'] ?? null; $server = null; if ( $server_id ) { $server = $adapter->get_server( $server_id ); if ( ! $server ) { \WP_CLI::error( sprintf( 'Server with ID "%s" not found.', $server_id ) ); } } else { // Use the first available server $server = array_values( $servers )[0]; $server_id = $server->get_server_id(); \WP_CLI::line( sprintf( 'Using server: %s', $server_id ) ); } // Set user context if specified if ( isset( $assoc_args['user'] ) ) { $user = $this->get_user( $assoc_args['user'] ); if ( ! $user ) { \WP_CLI::error( sprintf( 'User "%s" not found.', $assoc_args['user'] ) ); } wp_set_current_user( $user->ID ); \WP_CLI::debug( sprintf( 'Running as user: %s (ID: %d)', $user->user_login, $user->ID ) ); } else { \WP_CLI::debug( 'Running without authentication. Some capabilities may be limited.' ); } // Create and start STDIO server bridge try { \WP_CLI::debug( sprintf( 'Starting STDIO bridge for server: %s', $server_id ) ); // Create STDIO server bridge $stdio_bridge = new StdioServerBridge( $server ); // Start serving (this blocks until terminated) $stdio_bridge->serve(); } catch ( \RuntimeException $e ) { \WP_CLI::error( $e->getMessage() ); } catch ( \Throwable $e ) { \WP_CLI::error( 'Failed to start STDIO bridge: ' . $e->getMessage() ); } } /** * List all registered MCP servers. * * ## OPTIONS * * [--format=] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # List all MCP servers * wp mcp list * * # List servers in JSON format * wp mcp list --format=json * * @when after_wp_load * @synopsis [--format=] */ public function list( array $args, array $assoc_args ): void { $adapter = McpAdapter::instance(); $servers = $adapter->get_servers(); if ( empty( $servers ) ) { \WP_CLI::line( 'No MCP servers registered.' ); return; } $items = array(); foreach ( $servers as $server ) { $items[] = array( 'ID' => $server->get_server_id(), 'Name' => $server->get_server_name(), 'Version' => $server->get_server_version(), 'Tools' => count( $server->get_tools() ), 'Resources' => count( $server->get_resources() ), 'Prompts' => count( $server->get_prompts() ), 'Description' => $server->get_server_description(), ); } $format = $assoc_args['format'] ?? 'table'; format_items( $format, $items, array( 'ID', 'Name', 'Version', 'Tools', 'Resources', 'Prompts' ) ); } /** * Get a user by ID, login, or email. * * @param string $user User identifier (ID, login, or email). * @return \WP_User|false User object or false if not found. */ private function get_user( string $user ) { // Try as ID first if ( is_numeric( $user ) ) { return get_user_by( 'id', (int) $user ); } // Try as login $user_obj = get_user_by( 'login', $user ); if ( $user_obj ) { return $user_obj; } // Try as email return get_user_by( 'email', $user ); } }