Human In The Loop

🚀 人工介入式MCP服务器

这是一个MCP（模型上下文协议）服务器，它允许AI助手通过Discord向人类提问，旨在解决AI在工作中需要人类输入或判断的问题，提升AI工作的准确性和效率。

🚀 快速开始

本MCP服务器在AI助手工作过程中需要人类输入或判断时发挥作用。例如：

• 让大语言模型（LLM）创建文档时，由AI设计结构，人类提供具体内容。
• AI在做出不确定的决策时需要确认。
• 需要专业知识或个人信息时。

✨ 主要特性

• 支持AI助手在工作中向人类寻求帮助，通过Discord实现交互。
• 适用于多种MCP兼容的AI客户端，如Claude Desktop、Copilot Edits等。

📦 安装指南

环境要求

• Rust（1.70或更高版本）
• Discord账号和机器人
• MCP兼容的AI客户端（Claude Desktop、Copilot Edits等）

1. 创建Discord机器人

1. 访问 Discord开发者门户。
2. 创建一个新应用。
3. 在“Bot”部分创建一个机器人并获取令牌。
4. 设置所需权限：
   • 发送消息
   • 创建公共线程
   • 读取消息历史记录
5. 在“Bot”部分启用特权网关意图：
   • 消息内容意图

2. 安装服务器

cargo install --git https://github.com/KOBA789/human-in-the-loop.git

💻 使用示例

与MCP客户端连接

Claude Desktop配置

在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "human-in-the-loop": {
      "command": "human-in-the-loop",
      "args": [
        "--discord-channel-id", "channel-id",
        "--discord-user-id", "user-id"
      ],
      "env": {
        "DISCORD_TOKEN": "your-discord-bot-token"
      }
    }
  }
}

Claude Code配置

对于Claude Code（claude.ai/code），在MCP设置中添加以下内容：

{
  "mcpServers": {
    "human-in-the-loop": {
      "command": "human-in-the-loop",
      "args": [
        "--discord-channel-id", "channel-id",
        "--discord-user-id", "user-id"
      ]
    }
  }
}

在运行Claude Code之前，将Discord令牌设置为环境变量：

export DISCORD_TOKEN="your-discord-bot-token"
claude

注意：服务器会自动从 DISCORD_TOKEN 环境变量中读取Discord令牌。如有需要，也可以通过 --discord-token 参数传递。

基本使用

AI助手可以使用 ask_human 工具向人类提问：

Human: Please create a documentation outline. You can ask the human as you need.
Assistant: I'll create a documentation outline. Let me ask you some questions first.
[Uses ask_human tool]

AI会在Discord上发布问题并提及指定用户。当用户在Discord上回复时，回复内容将返回给AI。

🔧 技术细节

工作原理

1. AI助手调用 ask_human 工具。
2. MCP服务器在指定的Discord频道中创建一个线程（或使用现有线程）。
3. 发布问题并提及指定用户。
4. 等待用户回复。
5. 将回复内容返回给AI助手。

获取Discord ID

获取频道ID

1. 在Discord中启用开发者模式（设置 → 高级 → 开发者模式）。
2. 右键单击频道 → “复制ID”。

获取用户ID

1. 右键单击用户 → “复制ID”。

📚 详细文档

未来规划

• 未来迁移至MCP Elicitation：一旦MCP的Elicitation实现更加普及和标准化，我们计划将用户界面从Discord迁移到原生MCP Elicitation。这将在MCP兼容的客户端内直接提供更集成的体验。