Human In The Loop

🚀 人間介入型MCPサーバー

このサーバーは、AIアシスタントが作業中に人間の入力や判断を必要とする場合に使用されるMCP（Model Context Protocol）サーバーです。Discordを介してAIアシスタントが人間に質問を行うことができます。

🚀 クイックスタート

このMCPサーバーは、AIアシスタントが作業中に人間の入力や判断を必要とする場面で使用されます。例えば、LLMにドキュメントを作成させる際にAIが構造を設計し、人間が具体的な内容を提供する場合や、AIが不確かな判断について確認を必要とする場合、専門知識や個人情報が必要な場合などです。

✨ 主な機能

• AIアシスタントが作業中に人間の入力や判断を必要とする場面で使用可能
• Discordを介してAIアシスタントが人間に質問を行える

📦 インストール

必要条件

• Rust (1.70以上)
• Discordアカウントとボット
• MCP互換のAIクライアント（Claude Desktop、Copilot Editsなど）

セットアップ

1. Discordボットの作成

1. Discord Developer Portalにアクセスします。
2. 新しいアプリケーションを作成します。
3. Botセクションでボットを作成し、トークンを取得します。
4. 必要な権限を設定します：
   • メッセージを送信
   • 公開スレッドを作成
   • メッセージ履歴を読み取り
5. Botセクションで特権ゲートウェイインテントを有効にします：
   • メッセージ内容インテント

2. インストール

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

💻 使用例

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: ドキュメントのアウトラインを作成してください。必要に応じて人間に質問して構いません。
Assistant: ドキュメントのアウトラインを作成します。まずいくつかの質問をさせていただきます。
[ask_humanツールを使用]

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実装がより普及し、標準化されたら、UIをDiscordからネイティブのMCP Elicitationに移行する予定です。これにより、MCP互換クライアント内でより統合された体験が提供されます。