AskUserQuestionPlus

AskUserQuestionPlus is a Streamable HTTP MCP server that presents a web-based questionnaire interface for models to query users. It supports 1-20 questions per session with multiple types of questions (single choice, multiple choice) and optional custom input fields. The front-end communicates in real time via WebSocket, allowing seamless back-and-forth between the model and the user through the MCP interface. Tools available include Claude Code, Codex, and Gemini CLI integrations, enabling you to drive the questionnaire flow from your preferred model ecosystem. To use it, start the server, open the questionnaire in a browser, and answer the questions; the model will receive structured answers suitable for downstream reasoning or decision making.

Prerequisites:

• Node.js and npm (recommended LTS version)
• Internet access to fetch the MCP package

1. Install Node.js from https://nodejs.org/ if you haven't already.
2. Create a project directory and install the MCP server package (AskUserQuestionPlus will be run via npx as shown):

# Install dependencies (optional if just using npx directly)
npm install

3. Run the MCP server (foreground):

npx ask-user-question-plus

4. To run in the background or managed as a service, you can use a process manager like pm2 or run via Docker as described in the repository's deployment notes.

Notes:

• You can customize port and timeout via command line flags when starting the server (e.g., --port, --timeout).
• If you plan to run behind a reverse proxy, ensure the /mcp endpoint is exposed to the MCP clients.

Tips and common considerations:

• The server exposes an HTTP/WebSocket interface at /mcp for MCP clients. Ensure firewall rules allow external access if needed.
• For production, consider running behind a reverse proxy (Nginx/Traefik) and enabling TLS.
• The front-end supports keyboard navigation and an optional 'Other' field for free text per question. Configure model prompts to instruct the user accordingly.
• If you encounter issues with specific integrations (Claude Code, Codex, Gemini), verify the MCP URLs (http://localhost:3456/mcp/) and transport settings as shown in the README.
• The OK-to-use defaults are designed for rapid deployment; adjust timeout and port to fit your environment.