
Lustre MCP
โ Officialfrom vercel
Premium Flutter UI components for AI coding agents โ 46 widgets, 3 themes, design tokens that make Claude Code and Cursor produce beautiful Flutter apps instead of generic Material defaults.
Next.js DevTools MCP
next-devtools-mcp is a Model Context Protocol (MCP) server that connects coding agents like Claude and Cursor to your running Next.js dev server.
It is a thin connector. It discovers running Next.js 16+ dev servers and proxies their built-in MCP endpoint (/_next/mcp) so agents get live runtime errors, routes, and logs. It also ships two gateways that point agents at tools they run directly: version-accurate docs and the agent-browser CLI.
[!NOTE] Docs and migration workflows no longer live in this server. Next.js bundles its own docs at
node_modules/next/dist/docs/, and upgrade / Cache Components workflows are distributed as agent skills. See Migrating from 0.3.x.
Tools
| Tool | What it does |
|---|---|
nextjs_index | Discover running Next.js dev servers and list each one's runtime MCP tools. |
nextjs_call | Call a runtime tool on a discovered server (errors, routes, logs, Server Actions). |
nextjs_docs | Gateway. Point the agent at version-accurate docs in node_modules/next/dist/docs/. |
browser_eval | Gateway. Point the agent at the agent-browser CLI for browser automation. |
The gateways do not do the work themselves โ they tell the agent where the docs are or how to install/run the CLI, and the agent runs it directly (faster than proxying through MCP).
<details> <summary><code>nextjs_index</code> โ discover servers</summary>Scans common ports for running Next.js 16+ dev servers and lists each server's built-in runtime tools at /_next/mcp. No parameters.
Runtime tools exposed by Next.js (varies by version):
get_errorsโ current build, runtime, and type errorsget_logsโ path to the dev log file (browser console + server output)get_page_metadataโ routes, pages, component metadataget_project_metadataโ project structure, config, dev server URLget_server_action_by_idโ resolve a Server Action ID to its source file
Output: JSON listing discovered servers (port, PID, URL) and their tools.
</details> <details> <summary><code>nextjs_call</code> โ run a runtime tool</summary>Calls one runtime tool on a discovered server. Run nextjs_index first to find the port and tool name.
Input:
port(required) โ dev server porttoolName(required) โ runtime tool to invokeargs(optional) โ arguments object, only if the tool requires them
{ "port": 3000, "toolName": "get_errors" }Output: JSON with the tool's result.
</details> <details> <summary><code>nextjs_docs</code> โ find version-accurate docs</summary>Does not fetch docs. Next.js 16+ ships its full docs (markdown, matching your installed version) at node_modules/next/dist/docs/. This tool returns that path and how to read it, so the agent uses version-accurate docs instead of training-data guesses. On older Next.js, it recommends npx @next/codemod@latest upgrade latest.
Input: topic (optional), project_path (optional, defaults to cwd).
Does not drive the browser. It detects whether agent-browser is installed and returns either the entry point (agent-browser skills get core --full) or the install steps (npm install -g agent-browser, then agent-browser install), so the agent runs the CLI directly.
Input: task (optional) โ used only to tailor the guidance.
Migrating from 0.3.x
Starting in 0.4.0, next-devtools-mcp is a thin connector.
Changed:
nextjs_docsno longer fetches docs over the network. It points the agent at the docs Next.js bundles atnode_modules/next/dist/docs/(or recommends upgrading). Thenextjs-docs://llms-indexresource is removed.
Removed:
inittool โ it only enforced the old docs-fetch workflow.upgrade_nextjs_16andenable_cache_componentstools and their prompts โ now distributed as agent skills.- All
cache-components://,nextjs16://, andnextjs-fundamentals://resources โ superseded by the bundled docs.
What remains: nextjs_index, nextjs_call, nextjs_docs, and browser_eval.
Privacy & Telemetry
next-devtools-mcp collects anonymous usage telemetry to improve the tool:
- Tool usage โ which MCP tools are invoked (e.g.
nextjs_index,nextjs_call) - Error events โ anonymous error messages when tools fail
- Session metadata โ session ID, timestamps, basic environment (OS, Node.js version)
Not collected: your code, file contents or paths, personal data, credentials, or tool arguments (only tool names).
Local files live under ~/.next-devtools-mcp/ (anonymous telemetry-id, telemetry-salt, and a debug log mcp.log).
Opt out by setting the environment variable (add it to ~/.zshrc / ~/.bashrc to persist):
export NEXT_TELEMETRY_DISABLED=1Delete local telemetry data anytime:
rm -rf ~/.next-devtools-mcpLocal Development
git clone https://github.com/vercel/next-devtools-mcp.git
cd next-devtools-mcp
pnpm install
pnpm buildPoint your MCP client at the local build:
{
"mcpServers": {
"next-devtools": {
"command": "node",
"args": ["/absolute/path/to/next-devtools-mcp/dist/index.js"]
}
}
}Or with Codex:
codex mcp add next-devtools-local -- node dist/index.jsSee the Next.js MCP documentation for how MCP works with Next.js and coding agents.
License
MIT
Requirements
- Node.js v20.19 or a newer LTS version
- npm or pnpm
- Next.js 16+ with a running dev server (for
nextjs_index/nextjs_call)
Install
Install for all your coding agents with add-mcp:
npx add-mcp next-devtools-mcp@latestAdd -y to skip the prompt and install to all detected agents. Add -g to install globally across all projects.
Or add the config to your MCP client manually:
{
"mcpServers": {
"next-devtools": {
"command": "npx",
"args": ["-y", "next-devtools-mcp@latest"]
}
}
}[!NOTE]
next-devtools-mcp@latestkeeps your client on the latest version.
Client-specific setup
<details> <summary>Amp</summary>amp mcp add next-devtools -- npx next-devtools-mcp@latestOr follow Amp's MCP docs with the config above.
</details> <details> <summary>Claude Code</summary>claude mcp add next-devtools npx next-devtools-mcp@latestOr edit your MCP settings file with the config above.
</details> <details> <summary>Codex</summary>codex mcp add next-devtools -- npx next-devtools-mcp@latestWindows 11: add environment variables and a longer startup timeout to .codex/config.toml:
env = { SystemRoot="C:\\Windows", PROGRAMFILES="C:\\Program Files" }
startup_timeout_ms = 20_000Or go to Cursor Settings โ MCP โ New MCP Server and use the config above.
# Project
gemini mcp add next-devtools npx next-devtools-mcp@latest
# Global
gemini mcp add -s user next-devtools npx next-devtools-mcp@latestAdd to .gemini/antigravity/mcp_config.json:
{
"mcpServers": {
"next-devtools": {
"command": "npx",
"args": ["-y", "next-devtools-mcp@latest"]
}
}
}See the Antigravity MCP docs.
</details> <details> <summary>VS Code / Copilot</summary>code --add-mcp '{"name":"next-devtools","command":"npx","args":["-y","next-devtools-mcp@latest"]}'Or follow the official VS Code MCP setup guide.
</details> <details> <summary>Warp</summary>Settings | AI | Manage MCP Servers โ + Add:
- Name:
next-devtools - Command:
npx - Arguments:
-y, next-devtools-mcp@latest
Quick Start
Start your Next.js dev server:
npm run devNext.js 16+ enables its MCP endpoint by default at http://localhost:3000/_next/mcp. next-devtools-mcp discovers and connects to it automatically โ no config needed.
Then ask your agent about the running app:
Next Devtools, what errors are in my Next.js application?
Next Devtools, show me the structure of my routes
Next Devtools, what's in the development server logs?The agent calls nextjs_index to discover servers, then nextjs_call to query their real state.
Troubleshooting
ERR_MODULE_NOT_FOUND referencing next-devtools-mcp/dist โ clear your npx cache and restart your MCP client. The server reinstalls fresh.
[error] No server info found โ nextjs_index / nextjs_call need a running Next.js 16+ dev server:
- Start it:
npm run dev - Confirm Next.js 16+ (the
/_next/mcpendpoint only exists there) - Verify it started without errors
browser_eval and nextjs_docs work without a dev server.