金大哥 - worker17 MCP 详情

article

README

🚀 工人17号监控与控制系统（MCP启用的3D工人监控与控制）

工人17号监控与控制系统是一款功能强大的系统，可实现对工人17号的有效监控与控制。它能实时掌握工人17号的位置和状态，灵活发送任务指令，对表现不佳的情况及时终止任务。同时，借助Claude Desktop通过MCP进行各项操作，为管理工人17号提供了高效的解决方案。

🚀 快速开始

开发环境搭建

若要搭建开发环境，可按以下步骤操作：

# 启动服务器
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

此模式无需单独启动服务器进程，就能在浏览器中运行基于Node.js的开发环境。

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服务器。为使用工人17号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可视化。
服务器端支持：基于Node.js/Express框架，集成WebSocket支持和SSE MCP协议。
MCP集成：与Claude Desktop兼容，支持AI辅助的工人17号管理。

📦 安装指南

本系统提供多种安装和部署方式，包括开发环境搭建、WebContainer模式、Docker容器化部署等，具体步骤见“快速开始”部分。

🔧 技术细节

工人17号最初是一个玩笑性质的项目，后来演变成对SSE MCP服务器的研究探索。该项目虽有些荒诞，但为学习MCP协议提供了有趣的途径。系统主要由Web应用程序、服务器端和MCP集成三部分组成。Web应用程序使用React、Three.js和WebSocket实现工人17号状态的3D可视化；服务器端基于Node.js/Express框架，集成了WebSocket支持和SSE MCP协议；MCP集成与Claude Desktop兼容，支持AI辅助的工人17号管理。

worker17