Worker17

🚀 工人17號監控與控制系統（MCP啟用的3D工人監控與控制）

工人17號監控與控制系統是一個功能強大的系統，主要用於對工人17號進行監控和控制。它能即時掌握工人17號的位置與狀態，還可下達任務指令，甚至在其表現不佳時終止任務。同時，該系統藉助Claude Desktop通過MCP實現監控、控制及終止操作，為工人管理提供了高效的解決方案。

🚀 快速開始

開發環境搭建

在開始開發前，需要分別啟動服務器和Web應用程序。

# 啟動服務器
cd server
npm install
npm start

# 在另一個終端窗口中啟動Web應用程序
npm install
npm start

WebContainer模式

為了便於開發和演示，可通過WebContainer直接在瀏覽器中運行服務器代碼，無需單獨啟動服務器進程。

# 開發環境下的WebContainer運行（自動構建服務器代碼）
npm run dev:wc

# 生產環境下的WebContainer構建
npm run build:wc

# 預覽生產構建版本的WebContainer
npm run preview:wc

Docker容器化部署

也可以使用Docker來運行整個系統。

docker-compose up

⚠️ 重要提示

如果您使用WSL（Windows Subsystem for Linux）而沒有安裝Docker Desktop，當前版本存在一個bug，無法正確暴露端口。解決方法是使用主機網絡模式運行容器，但這可能會帶來一定的安全風險，因為繞過了容器的網絡隔離特性。

MCP Inspector工具

您可以通過MCP Inspector連接到工人17號MCP服務器，查看工人的狀態信息。選擇SSE傳輸協議，並將工人17號服務器地址設為http://localhost:4000/sse（或其他實際運行的服務器地址）。

Claude Desktop配置

當前Claude Desktop尚不支持直接連接SSE MCP服務器，需要一個代理Stdio MCP服務器。經過測試，推薦使用mcp-proxy。安裝完成後，請確保將該工具添加到系統路徑中（例如，在Windows環境下，用戶個人目錄下的bin文件夾）。 然後，在Claude Desktop的配置文件中添加工人17號MCP服務器：

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

⚠️ 重要提示

請確保在啟動Claude Desktop之前，工人17號服務器已經正常運行。

✨ 主要特性

• 全面監控與控制：可監控工人17號的位置和狀態，發送任務指令，還能因表現不佳而終止任務執行。
• 3D可視化界面：通過Web應用程序，使用React、Three.js和WebSocket實現工人17號狀態的3D可視化展示。
• MCP集成：與Claude Desktop兼容，支持AI輔助的工人17號管理。
• 多種部署方式：支持開發環境搭建、WebContainer模式、Docker容器化部署等多種部署方式。

📦 安裝指南

開發環境搭建

# 啟動服務器
cd server
npm install
npm start

# 在另一個終端窗口中啟動Web應用程序
npm install
npm start

WebContainer模式

# 開發環境下的WebContainer運行（自動構建服務器代碼）
npm run dev:wc

# 生產環境下的WebContainer構建
npm run build:wc

# 預覽生產構建版本的WebContainer
npm run preview:wc

Docker容器化部署

docker-compose up

📚 詳細文檔

工人17號最初只是一個玩笑性質的項目，隨後演變成對SSE MCP服務器的研究探索。該項目雖略顯荒誕，但也為學習MCP協議提供了一個有趣的學習途徑。

🔧 技術細節

該系統主要由以下部分組成：

• Web應用程序：使用React、Three.js和WebSocket實現的工人17號狀態3D可視化界面。
• 服務器端：基於Node.js/Express框架，集成WebSocket支持和SSE MCP協議的服務器實現。
• MCP集成：與Claude Desktop兼容，支持AI輔助的工人17號管理。