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兼容的客戶端內直接提供更集成的體驗。