human-in-the-loop

Human-in-the-Loop MCP Server

An MCP (Model Context Protocol) server that allows AI assistants to ask questions to humans via Discord.

Overview

This MCP server is used when AI assistants need human input or judgment during their work. For example:

• When having an LLM create documentation, the AI designs the structure while humans provide specific content
• When the AI needs confirmation on uncertain decisions
• When specialized knowledge or personal information is required

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. Go to Discord Developer Portal
2. Create a new application
3. Create a bot in the Bot section and obtain the token
4. Set required permissions:
   • Send Messages
   • Create Public Threads
   • Read Message History
5. Enable privileged gateway intents in Bot section:
   • Message Content Intent

2. Install

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

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 --discord-token argument if needed.

Usage

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

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 returned to the AI.

How It Works

1. AI assistant calls the ask_human tool
2. MCP server creates a thread in the specified Discord channel (or uses existing thread)
3. Posts the question and mentions the specified user
4. Waits for user's reply
5. 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 channel → "Copy ID"

Getting User ID

1. Right-click on user → "Copy ID"

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 provide a more integrated experience directly within MCP-compatible clients.