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号管理。