SuperAPI AI 工具集

next-devtools-guide

编程与开发

查看项目

更新于 10-15 21:46

技能介绍

用途:为已配置 next-devtools MCP 服务器的 Next.js 项目提供操作指导,覆盖运行时诊断、文档查询、浏览器测试与版本升级等场景。

主要能力:共 26 项功能,含 7 个工具、2 个提示和 17 个资源。工具包括 init(建立文档优先的 MCP 上下文)、nextjs_index(发现运行中的开发服务器与可用工具)、nextjs_call(在运行中的服务器上执行指定工具)、nextjs_docs(按路径获取官方文档)、browser_eval(Playwright 浏览器自动化测试)、enable_cache_components(迁移到 Next.js 16 Cache Components 模式)、upgrade_nextjs_16(升级到 Next.js 16 引导)。提示为 upgrade-nextjs-16 和 enable-cache-components。资源包括 Cache Components 相关 13 项(如 overview、core-mechanics、public-caches、private-caches、runtime-prefetching、request-apis、cache-invalidation、advanced-patterns、build-behavior、error-patterns、test-patterns、reference、route-handlers)及 use-client、Next.js 16 迁移、文档索引等 4 项。

使用方式:需 Node.js v20.19+、npm 或 pnpm,运行时诊断需 Next.js 16+。每个会话先调用 init;运行时诊断先运行 npm run dev(或 pnpm dev),再调用 nextjs_index 发现服务器,最后用 nextjs_call 配合 toolName 执行工具。nextjs_call 的 args 必须为对象,无参数时省略 args。文档检索先读 nextjs-docs://llms-index 资源获取正确路径,再调用 nextjs_docs。

适用场景:实现改动前了解应用状态、错误检测(toolName="get_errors")、路由检查(toolName="get_routes")、Server Action 追踪、Next.js 16 升级与 Cache Components 迁移、需要真实页面渲染时用 browser_eval。

限制与排障:工具命名遵循 mcp__plugin_next-devtools_next-devtools__<tool-name>;服务器未连接时需确认 Next.js v16+ 与 .mcp.json 配置并重启开发服务器,自动发现失败可询问端口;出现“No server info found”需确保开发服务器运行,Next.js 15 及更早版本可用 upgrade_nextjs_16;模块找不到时清理 npx 缓存并重启 MCP 客户端。价格、授权等信息资料暂未提供。