Get the FREE Ultimate OpenClaw Setup Guide →

opennextjs-cli

Interactive CLI/TUI for OpenNext.js + Cloudflare Workers. Automated setup, deployment, validation, and MCP server for AI-assisted development.

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio jsonbored-opennextjs-cli npx -y @jsonbored/opennextjs-mcp \
  --env OPENNEXTJS_MCP_HOST="optional: MCP host URL" \
  --env OPENNEXTJS_MCP_PORT="optional: MCP port" \
  --env OPENNEXTJS_MCP_LOG_LEVEL="optional: log level (info|debug|warn|error)"

How to use

The OpenNext.js MCP server exposes a Model Context Protocol (MCP) interface that lets AI tooling interact with your OpenNext.js projects. It exposes a curated set of tools to query project status, validate configurations, perform health checks, list environments, deploy to Cloudflare, start a local preview, and update configurations. This enables automated assistants to inspect your project, verify setup correctness, and perform deployments or previews without manual steps. You can access these tools via the MCP server endpoints exposed by the CLI integration and use the provided resources to locate relevant configuration files and project structure. The MCP also offers prompts to guide setup, troubleshoot deployments, and optimize your Cloudflare configuration, making it easier to integrate AI-driven workflows into your OpenNext.js project lifecycle.

How to install

Prerequisites:\n- Node.js 18.x or higher\n- npm or pnpm/yarn (pnpm recommended)\n- Git (optional but recommended)\n\nInstall the MCP server package globally:\nbash\nnpm install -g @jsonbored/opennextjs-mcp\n``\nIf you prefer using npx to run the MCP server on demand, you can skip global installation and run:\nbash\nnpx -y @jsonbored/opennextjs-mcp\n``\nOptionally, install the CLI tooling that configures and triggers the MCP server from the main CLI:\nbash\nnpm install -g @jsonbored/opennextjs-cli\n# or via alias if you have it set up (onjs)\n\nConfiguration via the CLI:\n1. Ensure you have a Next.js/OpenNext.js project.\n2. Run the MCP setup through the CLI to auto-configure the MCP server with the project.\nbash\nopennextjs-cli mcp setup\n\n3. Start using the MCP endpoints from your AI tooling once the CLI completes the setup.\n

Additional notes

Notes and tips:\n- The MCP server is tied to the OpenNext.js CLI workflow; running opennextjs-cli mcp setup will configure the MCP server for your project automatically.\n- Tools exposed by the MCP include: get_project_status, validate_configuration, check_health, list_environments, deploy_to_cloudflare, start_preview_server, and update_configuration.\n- Resources exposed include wrangler.toml, open-next.config.ts, package.json, and project structure.\n- If you see networking or permission issues, ensure Node.js permissions and network access for npm/pnpm/yarn registries.\n- You can tune the MCP via environment variables (host, port, log level). Use the mcp_config env block to set placeholders for deployment pipelines.\n- Restart the MCP after configuration changes to ensure tooling picks up updates.\n

Related MCP Servers

Sponsor this space

Reach thousands of developers