用途:检测 Web 项目类型并启动对应本地开发服务器,获取可访问的预览地址,便于部署与本地预览。
主要能力:自动识别 Node.js(package.json 的 dev/start 脚本)、PHP、Django、Flask、Gunicorn/uWSGI、通用 Python、Go、Ruby/Rails、Java/Spring Boot、Rust 及静态 HTML,并启动对应服务器;优先读取项目文档(.monkeycode/MEMORY.md、README、AGENTS.md)指定的启动方式;通过 MCP 工具 request_preview 获取预览地址并检测连接状态;支持查看日志、停止终端及添加 IP 白名单。
必要用法:使用 background_terminal_create 在后台启动服务器,严禁用 exec 直接启动;启动前先用 background_terminal_list 检查已有进程,避免端口冲突;通过 background_terminal_output_path 读取日志,确认出现 "Listening on port"、"ready in" 等标志后再取预览地址;停止服务器必须用 background_terminal_kill 加终端 ID,禁止 pkill/killall。静态服务默认端口 8000,Node.js 端口依项目配置。
适用场景:本地开发预览、需要后台运行并追踪日得的前后端项目部署。
限制:不含生产部署、域名或构建发布流程;各框架启动命令与端口以项目实际配置为准。