worker17

🚀 工人17

工人17是一个启用MCP的3D工人监控与控制系统，它能够实现对工人的全方位监控与控制，为管理工作带来极大便利。

🚀 快速开始

开发设置

# 启动服务器  
cd server  
npm install  
npm start  

# 在另一个终端中启动Webapp  
npm install  
npm start  

Web容器模式

用于开发和演示目的，可以直接在浏览器中运行服务器：

# 开发环境使用Web容器（自动构建服务器）  
npm run dev:wc  

# 为生产环境构建并使用Web容器  
npm run build:wc  

# 预览生产环境构建结果  
npm run preview:wc  

此模式会自动构建服务器代码并在浏览器中的Node.js环境中运行，无需单独的服务器进程。

Docker

也可以使用Docker运行系统：

docker-compose up  

⚠️ 重要提示

如果在没有Docker Desktop的WSL中运行Docker，目前存在一个阻止端口暴露的bug。临时解决方案是使用主机网络模式运行容器，但这可能会绕过容器的网络隔离，带来潜在风险。

MCP检查工具

可以使用MCP检查工具连接到工人17的MCP服务器并检查工人的状态。选择SSE传输方式，并提供工人17服务器的URL：http://localhost:4000/sse（或您运行服务器的实际URL）。

Claude Desktop

Claude Desktop目前不支持直接连接SSE MCP服务器。要使用工人17的MCP服务器，需要一个Stdio MCP代理。我测试过使用sparfenyuk/mcp-proxy Windows二进制文件，并将其添加到%USERPROFILE%.local\bin目录中。 然后可以在Claude Desktop配置中添加工人17的MCP服务器：

{
  "mcpServers": {
    "worker17": {
        "command": "mcp-proxy",
        "args": ["http://localhost:4000/sse"]
    }
  }
}

💡 使用建议

请确保服务器已启动并运行，再启动Claude Desktop。

✨ 主要特性

• 监控工人17的位置和状态。
• 向工人17发送任务。
• 因表现不佳而终止工人17。
• 通过MCP使用Claude Desktop监控、控制和终止工人17。

📦 安装指南

开发设置

# 启动服务器  
cd server  
npm install  
npm start  

# 在另一个终端中启动Webapp  
npm install  
npm start  

Web容器模式

# 开发环境使用Web容器（自动构建服务器）  
npm run dev:wc  

# 为生产环境构建并使用Web容器  
npm run build:wc  

# 预览生产环境构建结果  
npm run preview:wc  

Docker

docker-compose up  

🔧 技术细节

工人17系统是一个全面的系统，包括以下几个部分：

• Webapp：使用React、Three.js和WebSockets的工人17状态3D可视化界面。
• Server：Node.js/Express服务器，带有WebSocket支持和SSE MCP服务器实现。
• MCP集成：与Claude Desktop兼容，用于AI辅助管理工人17。

工人17最初只是一个恶作剧项目，后来演变成对SSE MCP服务器的探索。这是一个愚蠢的项目，但也是一种学习MCP的有趣方式。