Implore

Provides a quiz-style human input tool integrated as an MCP server with a GUI-based questionnaire.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kerodkibatu-implore-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

Implore MCP is a server that presents a quiz-style GUI to request input from humans. It lets you gather clarifications, choices, or knowledge through an interactive dialog, while the main MCP process stays responsive by running the GUI in a separate subprocess.

How to use

You integrate Implore MCP into your MCP client to gather user input during a session. When you need a decision, clarification, or specific information, invoke the implore tool from your client. The tool will display a scrollable dialog with questions, allow multiple question types, and return structured answers that you can use to drive your next steps.

Typical usage patterns include asking a single free-form question to capture user input, or presenting multiple choice questions to guide preferences while still offering an explicit "Other..." option for input beyond the predefined options. You can mix question types in a single session to gather both structured selections and open text. The GUI runs in a separate process to keep the MCP server responsive.

How to install

Prerequisites you need before installing Implore MCP are Python and a package/runner tool for MCPs, plus the GUI framework used by the tool.

Install the MCP runtime helper tool and GUI dependencies using the available package managers. The recommended steps are to install tooling, then install required Python packages for the server and GUI.

Step-by-step commands you can run to set up and start the server are shown below. Follow them exactly in order to ensure the server starts correctly.

uv sync

uv pip install fastmcp>=2.0.0 psutil>=7.0.0 pyside6>=6.8.2.1

# Or install directly with pip if you prefer:
# pip install fastmcp>=2.0.0 psutil>=7.0.0 pyside6>=6.8.2.1

# Start the server via UV (preferred for MCP workflows)
uv run server.py

# Or start with Python directly
python server.py

Additional notes

Configure the Implore MCP server in your MCP client by pointing to one of the supported startup commands. The two explicit runtime options shown here are designed to be simple to adopt: you can run the server with the UV tool or directly with Python, depending on your tooling preferences.

Environment considerations include ensuring GUI dependencies are present on the host system where the GUI subprocess will run. On some platforms, you may need additional platform-specific setup for the Qt-based GUI.

Available tools

implore

Displays a quiz-style GUI dialog to request input from the user. The dialog runs in a separate process and can handle multiple questions of different types, returning a structured map of question IDs to answers.