高通量制造控制平台服务器

Name: 高通量制造控制平台服务器
Author: AgentMP

作者：AgentMP2 星标更新：2025-11-07

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】

如何设置Claude Desktop以使用HITL MCP？

在AgentMP.ai上注册并获取API密钥：

https://agentmp.ai/createapikey

（您需要使用您的gmail或LinkedIn帐户登录）

获取本地设置Docker镜像并运行它：（前提条件 - 已安装并运行Docker桌面）

docker pull agentmp/hitl-mcp-server:latest

docker run -d \
  --name hitl-mcp-server \
  --env AGENTMP_API_KEY="<YOUR AGENTMP API KEY>" \
  --restart unless-stopped \
  -i \
  agentmp/hitl-mcp-server

配置claude_desktop.json

{
  "mcpServers": {
    "hitl": {
      "command": "docker",
      "args": ["exec", "-i", "hitl-mcp-server", "node", "app.js"],
      "env": {
        "AGENTMP_API_KEY": **"your_api_key_here"**
      }
    }
  }
}

在Claude中使用Cogito HITL

例如：

列出所有我的HITL升级

创建具有以下详细信息的HITL升级：

会话ID："test-session-123"
代理ID："claude-test-agent"
用户提示："用户希望购买高级订阅"
建议的操作：购买“高级计划”$29.99
升级到："karthik6461@gmail.com"
优先级："正常"

获取HITL升级"esc-[ID-FROM-TEST-2]"的详细信息

批准HITL升级"esc-[ID-FROM-TEST-2]"，评论："为了测试目的批准"

创建一个价值$50的软件许可证购买的HITL升级，然后将其修改为价值$75的企业许可证

接收推送通知

要在Slack/Teams/WhatsApp/Telegram上接收Cogito推送通知，请访问https://agentmp.ai/linkchannels，选择您首选的频道并配置您的频道标识符。

对于Teams和Slack，请联系您的频道管理员以启用AgentMP机器人。

我们正在积极添加其他渠道。如果您需要完全在防火墙内运行此MCP服务器，请联系ops@manifoldsystems.io

要在Postman上测试Cogito HITL API，您可以使用此仓库中的Postman集合-HITL.postman_collection.json。

请参阅此演示视频：

https://github.com/AgentMP/hitl-mcp-server/blob/main/HITLDemoVideo.mp4

HITL MCP服务器

它是什么？

HITL MCP服务器简化了与半自主AI代理的用户交互。代理可以执行任务并通过此MCP工具向人类寻求批准、状态更新、反馈和方向调整。用户交互被捕捉、存储以供未来改进。用户交互由最终用户选择的通道管理（Slack/Teams/WhatsApp/Telegram/网络浏览器）。

为什么？

标准化的交互，不假设用户坐在代理面前等待反馈/批准。
易于使用，无需安装新应用程序。
结构化的交互，存储并跟踪以供未来参考。
不依赖特定领域的实现。

为什么现在？

似乎没有单一的标准用于HITL。

这是一个模型上下文协议（MCP）服务器，它连接Claude Desktop与您的HITL（人在环中）升级服务。这允许Claude直接从Claude Desktop创建、批准、修改、拒绝和管理HITL升级。

https://hub.docker.com/r/agentmp/hitl-mcp-server

功能

创建HITL升级：创建带有建议操作的新升级请求
批准升级：批准待处理的升级，可选评论
修改升级：修改现有升级，带有新的行动
拒绝升级：拒绝升级，可选评论
获取升级详情：检索特定升级的详细信息
列出升级：列出认证用户的全部升级

如果您想自己构建和运行...

先决条件

Node.js 18+
Docker（可选，用于容器化部署）
您平台上的AGENTMP API密钥
Claude Desktop应用程序

步骤以在Claude Desktop上配置Cogito HITL

（请参阅SetupClaudeDesktop.md中的步骤）

设置

选项1：Docker部署（推荐）

克隆或创建项目文件：

mkdir hitl-mcp-server
cd hitl-mcp-server

创建所有必需的文件（app.js, package.json, package-lock.json, Dockerfile, docker-compose.yml）

设置您的API密钥：

export AGENTMP_API_KEY="your_api_key_here"

构建并运行容器：

chmod +x run.sh
./run.sh

或手动：

docker-compose up --build -d

选项2：本地Node.js部署（推荐用于故障排除）

安装依赖项：
```
npm install
```

设置您的API密钥：

export AGENTMP_API_KEY="your_api_key_here"

使用设置脚本：

chmod +x setup-local.sh
./setup-local.sh

或手动运行：
```
node app.js
```

测试您的设置

在配置Claude Desktop之前，测试您的设置：

# 直接测试服务器
export AGENTMP_API_KEY="your_api_key"
node app.js

如果正确工作，您应该看到：

🚀 启动HITL MCP服务器...
✅ 成功加载API密钥
🔧 设置请求处理器...
✅ 成功初始化HITL MCP服务器
🌟 HITL MCP服务器正在通过stdio运行并连接
📡 准备处理来自Claude Desktop的HITL请求

Claude Desktop配置

要在此MCP服务器上使用Claude Desktop，您需要在Claude Desktop设置中进行配置。

配置步骤

打开Claude Desktop
转到设置 → 开发者
编辑配置（这将打开您的MCP配置文件）
添加以下配置：

对于Docker部署：

{
  "mcpServers": {
    "hitl": {
      "command": "docker",
      "args": ["exec", "-i", "hitl-mcp-server", "node", "app.js"],
      "env": {
        "AGENTMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

对于本地Node.js部署：

{
  "mcpServers": {
    "hitl": {
      "command": "node",
      "args": ["/path/to/your/hitl-mcp-server/app.js"],
      "env": {
        "AGENTMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

保存配置文件
重启Claude Desktop

使用示例

一旦配置完成，您可以在Claude Desktop中使用以下命令：

创建一个HITL升级

为会话"sess-123"创建一个带有代理"my-agent"的HITL升级，购买"高级许可证"，价格为$99.99。升级到用户"user@example.com"，优先级为普通。

批准一个升级

批准HITL升级"esc-123456789"，评论："批准购买"

修改一个升级

修改HITL升级"esc-123456789"，更改项目为"企业许可证"，金额为$199.99，评论："升级为企业"

拒绝一个升级

拒绝HITL升级"esc-123456789"，评论："超出预算"

获取升级详情

获取HITL升级"esc-123456789"的详细信息

列出所有升级

列出我所有的HITL升级

可用工具

该MCP服务器提供以下工具：

create_hitl：创建一个新的HITL升级请求
approve_hitl：批准一个HITL升级
modify_hitl：修改一个HITL升级，带有新的行动
reject_hitl：拒绝一个HITL升级
get_hitl：获取特定HITL升级的详细信息
list_hitls：列出认证用户的全部HITL升级

环境变量

AGENTMP_API_KEY（必需）：您在AGENTMP平台上的API密钥

使用的API端点

服务器通过这些端点与您的HITL服务通信：

POST /api/hitl/mcp - MCP JSON-RPC端点用于创建、批准、修改
POST /api/hitl/{id}/reject - REST端点用于拒绝升级
GET /api/hitl/{id} - REST端点用于获取升级详细信息
GET /api/hitl - REST端点用于列出升级

故障排除

常见问题

"找不到容器：hitl-mcp-server"
- Docker容器未运行
- 运行：docker-compose up -d以启动它
- 检查：docker ps | grep hitl-mcp-server以验证其是否运行
- 建议：使用本地Node.js设置
"无法找到模块'@modelcontextprotocol/sdk/server/index.js'"
- 本地未安装依赖项
- 运行：npm install在项目目录中
- 确保您在正确的目录中，其中包含package.json
API密钥未设置
- 确保AGENTMP_API_KEY环境变量已正确设置
- 检查API密钥是否有效且具有适当的权限
容器无法启动
- 检查Docker日志：docker logs hitl-mcp-server
- 确保提供了环境中的API密钥
Claude Desktop无法识别服务器
- 验证Claude Desktop中的MCP配置语法
- 检查脚本路径是否正确（使用绝对路径）
- 在配置更改后重启Claude Desktop
- 对于本地设置，使用setup-local.sh提供的配置格式
连接问题
- 确保您的网络允许连接到backend.agentmp.io
- 检查是否有任何防火墙规则阻止连接

日志

对于Docker部署，查看日志：

docker logs hitl-mcp-server

对于本地部署，日志将出现在您运行npm start的终端中。

安全注意事项

安全存储您的API密钥，切勿将其提交到版本控制
容器作为非root用户运行以提高安全性
考虑在生产部署中使用Docker密钥
定期轮换您的API密钥

贡献

欢迎提交问题和增强请求！

许可证

MIT许可证

设置您的API密钥

export AGENTMP_API_KEY="99aeae0e6b4f4107a59d1b59010834cb3eb96ae0f667078f7cc2a296dad27785"

构建镜像

docker build -t hitl-mcp-server .

运行容器

docker run -d
--name hitl-mcp-server
--env AGENTMP_API_KEY="99aeae0e6b4f4107a59d1b59010834cb3eb96ae0f667078f7cc2a296dad27785"
--restart unless-stopped
-i
hitl-mcp-server

🎯 Claude Desktop配置

打开Claude Desktop → 设置 → 开发者 → 编辑配置，并添加以下内容：

📝 设置步骤

在Claude Desktop中保存上述配置
重启Claude Desktop
使用以下示例进行测试

🧪 简单测试案例

这里有一些从基础到高级的测试案例：

测试1：列出现有的HITL（基础）

列出我所有的HITL升级

预期结果：应显示您的现有HITL升级或空列表

测试2：创建一个HITL升级（核心功能）

创建具有以下详细信息的HITL升级：
- 会话ID："test-session-123"
- 代理ID："claude-test-agent"
- 用户提示："用户希望购买高级订阅"
- 建议的操作：购买“高级计划”$29.99
- 升级到："karthik6461@gmail.com"
- 优先级："正常"

预期结果：应返回类似"esc-xxxxx-xxxxx-xxxxx"的升级ID

测试3：获取HITL详细信息（验证）

获取HITL升级"esc-[ID-FROM-TEST-2]"的详细信息

用实际的ID替换[ID-FROM-TEST-2]，该ID来自测试2

测试4：批准HITL（操作）

批准HITL升级"esc-[ID-FROM-TEST-2]"，评论："为了测试目的批准"

测试5：创建和修改（高级）

创建一个价值$50的软件许可证购买的HITL升级，然后将其修改为价值$75的企业许可证

🔍 快速验证命令

在Claude中测试之前，验证您的容器：

# 检查容器是否运行
docker ps | grep hitl-mcp-server

# 检查容器日志
docker logs hitl-mcp-server

# 直接测试容器
docker exec -i hitl-mcp-server node -e 'console.log("✅ 容器正在工作！")'

📊 预期Claude响应

如果正确工作，Claude应该：

✅ 自动识别HITL工具
✅ 创建升级并返回类似esc-xxxxx-xxxxx-xxxxx的ID
✅ 显示带有升级详细信息的JSON响应
✅ 处理批准/修改/拒绝操作

🚨 如果出现问题

检查Docker日志：docker logs hitl-mcp-server
在任何配置更改后重启Claude Desktop
验证容器是否运行：docker ps | grep hitl-mcp-server

从测试1（列出HITL）开始 - 这是最安全的，可以确认连接是工作的！