AskMeMCP - Human-in-the-Loop

Provides interactive human-in-the-loop MCP capabilities with real-time UI for questions, decisions, and hypotheses.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 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": {
    "roman-vm-ask-me-mcp": {
      "command": "node",
      "args": [
        "C:/Temp/_Work/ask-me-mcp/dist/askme-server/main.js"
      ],
      "env": {
        "YOUR_ENV_PLACEHOLDER": "<YOUR_ENV_PLACEHOLDER>"
      }
    }
  }
}

AskMeMCP is a Model Context Protocol (MCP) server that lets AI assistants request human input through a web interface. It supports multiple interactive tools and provides a self-contained UI, real-time updates, and automatic port handling to make human-in-the-loop workflows smooth and reliable.

How to use

Once you have the MCP server running, you can use it with supported MCP clients to pause execution and gather human input through a web UI. Available tools include asking a single question, presenting multiple-choice options, challenging a hypothesis, and guiding a decision flow. The server opens the UI automatically when requests arrive and streams live updates so you can monitor responses in real time.

How to install

Prerequisites you need before installing: Node.js and a package manager (npm, pnpm, or yarn). You will install dependencies, then build the server and the UI for production.

npm install   # or: pnpm install / yarn install

# Build the production server
npx nx build askme-server

# Build the production UI
npx nx build askme-ui

Build from source and run in stdio mode

If you prefer building from source and running locally in stdio mode, you can configure the MCP server to start via a local node process. The runtime command below shows how to run the built server from a typical Windows path. Adapt the path to your environment if needed.

"ask-me-mcp": {
  "command": "node",
  "args": [
    "C:/Temp/_Work/ask-me-mcp/dist/askme-server/main.js"
  ],
  "disabled": false,
  "disabledTools": [
    "choose-next",
    "challenge-hypothesis",
    "ask-multiple-choice"
  ]
}

Build from source flow (optional)

If you want to build everything from source and then run the MCP server, follow this flow: clone the repository, install dependencies, and build all projects. Then configure your MCP client to launch the server from the built output.

git clone https://github.com/roman-vm/ask-me-mcp.git
cd ask-me-mcp

# Install dependencies
npm install

# Build all projects
npm run build

Available tools

ask-one-question

Prompt a single question to the human collaborator and receive a concise answer via the UI.

ask-multiple-choice

Present a set of questions with multiple selectable options and optional comments for each choice.

challenge-hypothesis

Pose a hypothesis for evaluation, inviting the human to provide evidence-based feedback or refutation.

choose-next

Offer a sequence of potential next actions or steps and let the human choose the most appropriate path.