Next AI Draw.io MCP Server 端口 6002 被占用怎么解决

Next AI Draw.io MCP Server 端口 6002 被占用怎么解决【免费下载链接】next-ai-draw-ioA next.js web application that integrates AI capabilities with draw.io diagrams. This app allows you to create, modify, and enhance diagrams through natural language commands and AI-assisted visualization.项目地址: https://gitcode.com/GitHub_Trending/ne/next-ai-draw-io在配置好 Claude Desktop、Cursor、VS Code 或 Cline 等 MCP 客户端后如果 Next AI Draw.io 的 MCP Servernext-ai-drawio/mcp-server启动时内置 HTTP 服务端口 6002 已被其他进程占用会出现端口冲突。这个内置 HTTP 服务负责向浏览器提供 draw.io 预览界面是实时绘图预览的通道端口冲突会直接影响start_session能否正常打开预览窗口。端口 6002 在本仓库中并不是一个随意的数字MCP Server 的内置 HTTP 服务默认端口就是6002见 MCP Server 文档的配置表而项目 Web 应用的开发服务器npm run dev也运行在 6002 上package.json 中dev脚本为next dev --turbopack --port 6002根 README 提示在 http://localhost:6002 查看应用。如果你同时开着 Web 应用的开发服务器6002 就很可能已经被占用。处理这个问题的核心结论来自 MCP Server 文档的 Troubleshooting 章节如果 6002 被占用服务会自动尝试下一个可用端口最多到 6020你也可以通过PORT环境变量手动指定一个端口。下面按这两条路径给出操作和验证方法。确认实际生效的端口自动换端口的行为MCP Server 不需要你手动杀掉占用 6002 的进程。服务在启动时如果收到端口占用EADDRINUSE会从原端口开始逐个向上尝试直到 6020 为止。这一行为在 http-server.ts 的startHttpServer中实现默认端口 6002常量MAX_PORT 6020每遇到一次EADDRINUSE就port 1重试。启动后有两个地方可以看到实际生效的端口日志MCP Server 的所有日志都写入 stderr前缀[MCP-DrawIO]见 logger.ts。发生换端口时会出现[MCP-DrawIO] [INFO] Port 6002 in use, trying 6003 [MCP-DrawIO] [INFO] HTTP server running on http://localhost:6003start_session的返回内容工具返回的文本中包含 Session ID 和 Browser URLURL 的端口就是实际绑定的端口。例如示例结果端口取决于实际占用情况Session started successfully! Session ID: mcp-xxxxxx Browser URL: http://localhost:6003?mcpxxxxxx打开这个 URL 时浏览器应能加载 draw.io 预览界面。如果页面没反应按文档提示先检查 URL 中是否带有?mcp查询参数——MCP 会话 ID 靠这个参数把浏览器和服务器关联起来。也就是说默认情况下端口被占用不会导致功能失败只是预览窗口换到另一个端口打开。如果你接受自动换端口到此为止即可。手动指定端口通过 PORT 环境变量固定如果端口不可预测会带来困扰比如你需要记住固定地址或 6002–6020 区间内多个端口都被占可以在 MCP 客户端配置中通过env显式设置PORT。文档给出的配置示例是把端口设为6003{ mcpServers: { drawio: { command: npx, args: [next-ai-drawio/mcp-serverlatest], env: { PORT: 6003 } } } }6003只是文档示例值替换成你确认空闲的目标端口即可。各客户端的配置文件位置均来自 MCP Server 文档Claude DesktopmacOS 下为~/Library/Application Support/Claude/claude_desktop_config.jsonVS Code工作区的.vscode/mcp.json或用户设置Cursor~/.cursor/mcp.jsonClineVS Code 扩展通过 Cline 顶部菜单的 MCP Servers → Configure 打开cline_mcp_settings.json编辑如果你是用 Claude Code CLI 添加的claude mcp add drawio -- npx next-ai-drawio/mcp-serverlatest文档没有给出 CLI 下设置env的写法此时建议使用上面这些 JSON 配置文件来指定端口。修改配置后需要重启 MCP 客户端使配置生效。结果验证与边界情况完成配置后按下面顺序核对重启 MCP 客户端让 AI 执行start_session或者直接说“创建一个流程图”触发会话。查看返回的 Browser URL端口应等于你设置的PORT值若未设置PORT则端口应 ≥ 6002若 6002 空闲则就是 6002。浏览器打开该 URL确认 draw.io 预览界面加载后续 AI 修改图表时画面实时更新。需要注意的边界整个 6002–6020 区间都被占用时会自动换端口机制失效服务会启动失败并报No available ports in range 6002-6020见 http-server.ts。这时需要释放区间内的端口或把PORT设到区间外。内置 HTTP 服务只监听本机回环地址代码中为server.listen(port, 127.0.0.1)所以预览只能在启动 MCP Server 的同一台机器上访问不要指望其他设备能打开这个地址。如果你占用 6002 的是本仓库 Web 应用的npm run dev两者同时运行没有问题——MCP Server 会自动让位换端口只有在你需要两者都固定在同一端口时才需要处理冲突。会话失效start_session报 No active session 一类问题与端口无关先确认是否调用过start_session打开浏览器窗口。相关文档MCP Server README安装、配置表与 TroubleshootingClaude Code 插件说明PORT 默认值同为 6002内置 HTTP 服务实现【免费下载链接】next-ai-draw-ioA next.js web application that integrates AI capabilities with draw.io diagrams. This app allows you to create, modify, and enhance diagrams through natural language commands and AI-assisted visualization.项目地址: https://gitcode.com/GitHub_Trending/ne/next-ai-draw-io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考