AskMeMCP Server

Provides a self-contained MCP server with a web UI for human-in-the-loop interactions and multiple interactive tools.

typescript

1

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": {
    "thlandgraf-askme-mcp": {
      "command": "npx",
      "args": [
        "--yes",
        "ask-me-mcp"
      ],
      "env": {
        "ASK_ME_MCP_DEBUG": "1"
      }
    }
  }
}

AskMeMCP enables AI assistants to pause execution and request human input through a web interface. It supports multiple interactive tools, letting you collect single questions, handle multiple choices, challenge hypotheses, and manage multi-step decision workflows in a streamlined MCP session.

How to use

You run the MCP server locally and connect it to your MCP client. When you trigger a tool from your client, the server serves a web UI where human responses are entered in real time. Tools can pause execution to wait for input, provide live updates, and then resume your workflow once responses are received.

How to install

Prerequisites: Node.js installed on your system. You should have npm or npx available in your environment.

Option 1 — Use npx (no installation required)

npx ask-me-mcp

Note: The first run may ask for confirmation to install temporarily. To skip this confirmation, use the following variant.

npx --yes ask-me-mcp

Option 2 — Global installation

npm install -g ask-me-mcp
ask-me-mcp

Option 3 — Build from source

# Clone the repository
# git clone https://github.com/yourusername/AskMeMCP.git
# cd AskMeMCP

# Install dependencies
npm install

# Build all projects
npm run build

# Start the server
npx --yes ask-me-mcp

Configuration notes

Port configuration allows you to run on the default auto-discovered port or specify a fixed port. By default, the server searches for an available port starting at 3000. To force a specific port, include --port in the start command.

Examples showing how to configure the port in different setups are provided for various MCP clients. For instance, you can run with a fixed port using:

npx --yes ask-me-mcp --port 8080

Available tools

ask-one-question

Prompt a user with a single question and collect the answer through the web UI.

ask-multiple-choice

Present multiple questions with a set of options, allow multiple selections, and capture annotated feedback for each choice.

challenge-hypothesis

Pose a hypothesis to be evaluated by a human, enabling iterative refinement based on human input.

choose-next

Model a workflow that asks for guidance on the next step and captures human-directed decisions.