SuperAPI AI 工具集

finding-dev-server-url

编程与开发

查看项目

更新于 10-16 02:22

技能介绍

Finding Dev Server URL 是一个用于检测本机正在运行的开发服务器、识别其端口并打开对应应用的技能。

用途 在本地开发过程中,往往同时运行多个开发服务器,该技能帮助快速找出哪些服务器正在运行、监听在哪个端口,并可直接在 Cursor 内置浏览器中打开查看。

主要能力

  • 列出所有终端:通过 ls <terminals_folder>/*.txt 列出终端输出文件。
  • 读取终端元数据:读取每个终端文件的前约 10 行,获取 pid(进程 ID)、cwd(工作目录)、last_command(正在运行的命令,如 npm run dev、pnpm dev、python manage.py runserver)。对于明显不是服务器的命令(如 git status、ls、cd)会跳过。
  • 扫描服务器 URL:对疑似运行服务器的终端读取完整内容,匹配各框架的启动输出模式,包括 Next.js、Vite、Create React App、Express、Django、Rails、Flask、Go、PHP、Remix、Astro、Nuxt。通用正则:https?://(localhost|127.0.0.1|0.0.0.0)(:\d+);同时检查独立端口模式:(listening|started|running|ready|serving).(port\s|:)\s*(\d{4,5})。
  • 报告结果:打印汇总,例如“Dev servers found: Terminal 1 (pid 12345) — npm run dev → http://localhost:3000 (cwd: /Users/me/app)”。若未找到服务器,则说明并建议启动一个。
  • 可选在浏览器中打开:使用 Cursor 内置浏览器 browser_navigate 访问 http://localhost:<port>,并通过 browser_take_screenshot 截图确认渲染。

使用方式 该技能依赖 Cursor 将实时终端输出存储在文本文件中,每个终端对应 <terminals_folder>/<id>.txt,terminals 文件夹路径由系统上下文提供。文件包含元数据(pid、cwd、last_command)及完整终端输出。按上述工作流依次执行即可。

适用场景

  • 本地同时运行多个开发服务器,需要快速定位端口。
  • 需要确认某个服务是否已启动、监听在哪个地址。
  • 希望在 Cursor 内置浏览器中直接预览应用。

限制与提示

  • 若发现多个服务器,应询问用户要打开哪一个。
  • 若终端显示错误(如 EADDRINUSE、address already in use),应报告端口冲突。
  • 若服务器崩溃(进程退出),也应指出,可检查终端文件尾部的 exit_code。
  • 常见默认端口:Next.js (3000)、Vite (5173)、Django (8000)、Rails (3000)、Flask (5000)、Go (8080)。
  • 关于收费、价格、平台支持范围等更多信息,资料暂未提供。