ask-user-mcp

Summary

ask-user-mcp is a Model Context Protocol (MCP) server that facilitates asking questions to the user and receiving their responses. It provides a simple HTTP and WebSocket interface for a model to interact with a human user. When the model asks a question, it is displayed on a web interface, and the user can provide an answer which is then returned to the model.

Installation

1. Clone the repository (or download the source code):

   git clone https://github.com/ac2302/ask-user-mcp.git
   cd ask-user-mcp

2. Install dependencies using pnpm:

   pnpm install

Usage

To start the ask-user-mcp server, you can use one of the following commands:

• With default port (7878):

  npx ask-user-mcp

• With a specified port number:

  npx ask-user-mcp <PORT_NUMBER>

  (e.g., npx ask-user-mcp 8080)

Running on startup with cron:

While you can configure ask-user-mcp to run automatically on system reboot using cron by adding the following line to your crontab:

@reboot npx -y ask-user-mcp@latest

Note: Running ask-user-mcp via cron is not recommended because it will not be able to open the browser window. For automatic startup, it's best to run npx -y ask-user-mcp@latest in an environment where it has access to a display, such as your window manager's configuration (e.g., ~/.xinitrc, ~/.config/openbox/autostart, or similar for your specific Linux distribution and window manager).

Once the server is running, it will open a browser window to http://localhost:<PORT_NUMBER> (or http://localhost:7878 if no port is specified) where the user can see questions from the model and provide answers.

Connection Instructions

To connect your MCP Client to this server, use the following configuration:

{
  "mcpServers": {
    "ask-user": {
      "type": "streamable-http",
      "url": "http://localhost:7878/mcp",
      "note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
    }
  }
}

Note: If you run the server on a different port, make sure to update the url in the connection instructions accordingly (e.g., http://localhost:8080/mcp).