human-in-the-loop

KO | EN

gitlite — search

#javascript #react #typescript #llm #go #android #deep-learning #linux #nodejs #windows #awesome #awesome-list #security #open-source

human-in-the-loop

(★ 230)

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

File Explorer

Download Latest Version (.zip)

- discord.rs
- main.rs
- tools.rs
.gitignore
Cargo.lock
Cargo.toml
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://discord.com/developers/applications)
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

```bash
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`:

```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:

```json
{
  "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:

```bash
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.

human-in-the-loop

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

human-in-the-loop

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README