] * : 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()); } } /** * 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); } /** * 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')); } }