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