Human-In-the-Loop

Human-In-the-Loop

A Model Context Protocol (MCP) server enabling AI assistants to interact with humans via GUI dialogs.

114
Stars
9
Forks
0
Releases

Overview

Human-In-the-Loop MCP Server is a powerful MCP server that enables AI assistants like Claude to interact with humans through intuitive GUI dialogs. It bridges automated AI processes and human decision-making by providing real-time user input tools, options, confirmations, and feedback mechanisms. The server supports non-blocking operation by running dialogs in separate threads to prevent blocking, and it enforces a configurable 5-minute timeout to avoid hangs. Available tools include get_user_input, get_user_choice, get_multiline_input, show_confirmation_dialog, show_info_message, and health_check. The GUI is cross-platform via tkinter, with a modern Windows-style interface, native macOS experience, and Ubuntu-friendly Linux styling. Platform detection, keyboard navigation, and comprehensive error handling contribute to a responsive and robust user experience. The MCP server is designed for workflows requiring human validation, user preferences, or detailed input before proceeding, and it can be integrated with Claude Desktop using claude_desktop_config.json. This server emphasizes real-time human feedback, clear status messages, and graceful recovery across Windows, macOS, and Linux environments.

Details

Owner
GongRzhe
Language
Python
License
MIT License
Updated
2025-12-07

Features

Interactive Dialog Tools

Bundle of GUI dialog utilities enabling real-time user input, choices, confirmations, and information messages.

Text Input

Get single-line text, numbers, or other data from users with optional validation.

Multiple Choice

Present options for single or multiple selections to guide user decisions.

Multi-line Input

Collect longer text content, code, or detailed descriptions.

Confirmation Dialogs

Ask for yes/no decisions before proceeding with actions.

Information Messages

Display notifications, status updates, and results.

Health Check

Monitor server status and GUI availability.

Non-blocking Operation

Dialogs run in separate threads to prevent blocking the main workflow.

Audience

AI developersEmbed human-in-the-loop dialogs into AI workflows for real-time user input and decisions.
Claude Desktop usersConfigure Claude Desktop to connect with the MCP server for GUI dialogs.
Cross-platform developersBuild cross-platform GUI dialogs for AI workflows on Windows, macOS, and Linux.

Tags

MCPModel Context ProtocolGUItkinterhuman-in-the-loopinteractive-dialogscross-platformWindowsmacOSLinuxClaudehealth-checkthreading