🚀 工人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的有趣方式。