Worker17 MCP服务器使用说明

项目简介

Worker17 是一个模拟3D Worker监控和控制系统，其服务端实现了MCP服务器，允许用户通过MCP客户端（如Claude Desktop或MCP Inspector）与Worker17系统进行交互。该MCP服务器通过SSE（Server-Sent Events）协议提供服务，允许客户端实时获取Worker状态和调用预定义的功能。

主要功能点

资源管理：
- 提供Worker资源，允许客户端查询当前连接的Worker列表及其基本信息（如状态、电量等）。
- 允许客户端获取特定Worker的详细状态信息。
工具注册与执行：
- 提供“获取Worker状态 (get-status)”工具，允许客户端查询指定Worker的详细状态。
- 提供“终止Worker (terminate)”工具，允许客户端发送指令终止指定Worker的运行。
- 提供“获取相机图像 (getCameraImage)”工具，允许客户端请求并获取指定Worker的摄像头图像。
Prompt 模板：
- 虽然仓库描述中没有明确提及Prompt模板，但作为MCP服务器，它为LLM客户端提供了结构化的数据访问和工具调用能力，可以与Prompt模板结合使用，以实现更复杂的LLM应用场景。

安装步骤

克隆仓库:

git clone https://github.com/kortexa-ai/worker17.git
cd worker17/server

安装依赖:
```
npm install
```
启动服务器:
```
npm start
```
服务器默认在 'http://localhost:4000' 启动，MCP SSE 服务端点为 'http://localhost:4000/sse'。

服务器配置 (MCP客户端)

要让MCP客户端（如Claude Desktop）连接到 Worker17 MCP 服务器，您需要配置客户端的MCP服务器设置。以下是针对 Claude Desktop 的配置示例，请注意 Claude Desktop 目前可能不支持 SSE MCP 服务器，可能需要使用 mcp-proxy 进行桥接，具体配置请参考仓库 README 文档。 以下配置仅为示例，实际配置可能需要根据客户端类型和具体情况调整。

{
  "mcpServers": {
    "worker17": {
        "command": "请替换为MCP客户端启动命令或代理命令",
        "args": ["请替换为SSE服务地址，例如：http://localhost:4000/sse"]
    }
  }
}

配置参数说明:

server name (worker17): MCP 服务器的名称，可以自定义，用于在客户端中标识不同的 MCP 服务器连接。
command: 对于 Claude Desktop 或其他可能不支持 SSE 的客户端，这里通常需要配置 'mcp-proxy' 的启动命令。 如果客户端直接支持 SSE，则可能不需要代理，'command' 可以是客户端自身的某个内部命令或者留空，具体取决于客户端的设计。请务必参考客户端的官方文档来确定正确的配置方式。
args: 对于 'mcp-proxy' 代理，'args' 需要包含 Worker17 MCP 服务器的 SSE 服务地址 'http://localhost:4000/sse'。 如果客户端直接连接 SSE 服务，'args' 可能需要调整或为空。

重要提示:

SSE 支持: 请确认您的 MCP 客户端是否直接支持 SSE 协议。如果不支持，您可能需要按照仓库 README 提示使用 'mcp-proxy' 等工具进行协议转换。
端口和地址: 确保 MCP 客户端配置的服务器地址和端口与 Worker17 MCP 服务器实际运行的地址和端口一致。
防火墙: 如果遇到连接问题，请检查防火墙设置，确保端口 '4000' (或其他您配置的端口) 允许客户端访问。

基本使用方法

启动 Worker17 MCP 服务器 (按照安装步骤)。
配置并启动 MCP 客户端 (例如 Claude Desktop 或 MCP Inspector)，并根据客户端类型配置连接到 Worker17 MCP 服务器。
在 MCP 客户端中，您应该能够：
- 查看可用的 Worker 资源列表。
- 获取特定 Worker 的详细状态信息。
- 调用 "get-status"、"terminate" 和 "getCameraImage" 等工具来管理 Worker17 系统。

通过 MCP 客户端，您可以以标准化的方式与 Worker17 系统进行交互，例如，在 Claude Desktop 中，您可以利用自然语言指令，结合 Worker17 MCP 服务器提供的资源和工具，实现对虚拟 Worker 的监控和控制。

关键词