Worker17

一个启用MCP的3D工人监控与控制系统

概述

Worker17是一个综合系统，允许您：

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

该系统由以下部分组成：

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

更严肃地说？

Worker17最初是一个实际的玩笑，然后它变成了对SSE MCP服务器的探索。这是一个愚蠢的项目，但也是一个学习MCP的好方法。

快速开始

开发环境设置

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

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

WebContainer模式

为了开发和演示目的，您可以直接在浏览器中使用WebContainer运行服务器：

# 使用WebContainer进行开发（自动构建服务器）
npm run dev:wc

# 使用WebContainer构建生产环境
npm run build:wc

# 使用WebContainer预览生产构建
npm run preview:wc

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

Docker

您也可以使用Docker运行该系统：

docker-compose up

注意：如果您在没有Docker Desktop的情况下在WSL中运行docker，当前有一个bug会导致端口无法暴露。 解决办法是使用主机网络模式运行容器。然而，这可能会带来潜在风险，因为它绕过了容器的网络隔离。

MCP Inspector

您可以使用MCP Inspector连接到Worker17 MCP服务器并检查工人的状态。选择SSE传输并提供worker17服务器URL：http://localhost:4000/sse（或您正在运行服务器的任何URL）。

Claude Desktop

目前，Claude Desktop不支持SSE MCP服务器。要使用Worker17 MCP服务器，您需要一个代理Stdio MCP服务器。我已测试过mcp-proxy。您需要将其安装为Windows应用程序并放入路径中。我使用了添加到%USERPROFILE%.local\bin的Windows二进制文件uv。

然后，您可以将worker17 MCP服务器添加到Claude Desktop配置中：

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

确保服务器已经启动并运行后再启动Claude Desktop。