Human In The Loop

🚀 Human-in-the-Loop MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to pose questions to humans through Discord.

🚀 Quick Start

This MCP server comes into play when AI assistants need human input or judgment during their operations. For instance:

• When an LLM is tasked with creating documentation, the AI devises the structure while humans supply the specific content.
• When the AI requires confirmation on uncertain decisions.
• When specialized knowledge or personal information is necessary.

✨ Features

• Facilitates human - in - the - loop interactions for AI assistants via Discord.
• Supports multiple MCP - compatible AI clients like Claude Desktop and Copilot Edits.

📦 Installation

Requirements

• Rust (1.70 or higher)
• Discord account and bot
• MCP - compatible AI client (Claude Desktop, Copilot Edits, etc.)

Setup

1. Create Discord Bot

1. Navigate to Discord Developer Portal.
2. Create a new application.
3. Create a bot in the Bot section and acquire the token.
4. Set the necessary permissions:
   • Send Messages
   • Create Public Threads
   • Read Message History
5. Enable privileged gateway intents in the Bot section:
   • Message Content Intent

2. Install

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

💻 Usage Examples

Connecting with MCP Clients

Claude Desktop Configuration

Add the following to 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 Configuration

For Claude Code (claude.ai/code), add to your MCP settings:

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

Set the Discord token as an environment variable before running Claude Code:

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

Note: The server automatically reads the Discord token from the DISCORD_TOKEN environment variable. You can also pass it via the --discord-token argument if required.

Basic Usage

AI assistants can use the ask_human tool to ask questions to humans:

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]

The AI posts questions in Discord and mentions the specified user. When the user replies in Discord, the response is sent back to the AI.

🔧 Technical Details

How It Works

1. The AI assistant invokes the ask_human tool.
2. The MCP server creates a thread in the specified Discord channel (or re - uses an existing one).
3. It posts the question and mentions the specified user.
4. It waits for the user's reply.
5. It returns the reply content to the AI assistant.

Finding Discord IDs

Getting Channel ID

1. Enable Developer Mode in Discord (Settings → Advanced → Developer Mode).
2. Right - click on the channel and select "Copy ID".

Getting User ID

1. Right - click on the user and select "Copy ID".

📚 Documentation

Roadmap

• Future Migration to MCP Elicitation: Once MCP's Elicitation implementation becomes more widespread and standardized, we plan to migrate the UI from Discord to native MCP Elicitation. This will offer a more integrated experience directly within MCP - compatible clients.