AskUserQuestionPlus
Allows Gemini CLI to ask users questions via a web interface, supporting single/multiple choice and custom input.
Allows Codex (OpenAI's CLI) to ask users questions via a web interface, supporting single/multiple choice and custom input.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AskUserQuestionPlusask me 3 questions about my project requirements"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AskUserQuestionPlus
A MCP server (Streamable HTTP) for asking user questions via a web interface, inspired by the Claude Code AskUserQuestion Tool.
🌟 Supports Claude Code, Codex, and Gemini CLI!
✨ 特性
🎨 精美界面：Claude Code AskUserQuestions 风格样式，支持暗/浅色主题适配
⌨️ 全键盘操作：支持方向键、Tab、Space、Enter 快捷键，操作流畅
📊 丰富交互：支持单选、多选、推荐选项标记以及自定义输入（Other）
🔄 实时通信：基于 WebSocket 的实时消息传递，响应迅速
⏱️ 超时保护：可配置会话超时时间（默认 10 分钟）
📈 高度可扩展：支持 1-20 个问题，每个问题选项数量不限
Related MCP server: Sequential Questioning MCP Server
🚀 部署
启动参数
参数 | 说明 | 默认值 | 示例 |
| 会话超时时间 | 600000 (10 分钟) |
|
| 监听端口 | 3456 |
|
前台运行
npx ask-user-question-plus
# 自定义端口和超时
npx ask-user-question-plus -- --port=3456 --timeout=600000后台运行（推荐）
使用 pm2
需先安装 pm2:
npm install -g pm2
pm2 start "npx ask-user-question-plus" --name ask-user-question-plus-service
# 带参数启动
pm2 start "npx ask-user-question-plus -- --port=3456 --timeout=600000" --name ask-user-question-plus-service
# 停止服务
pm2 stop ask-user-question-plus-service
# Windows
pm2 start cmd --name ask-user-question-plus-service -- /c npx ask-user-question-plus使用 Docker
docker compose up -d⚙️ 配置
Claude Code
claude mcp add -s user -t http AskUserQuestionPlus http://localhost:3456/mcpCodex
在 ~/.codex/config.toml 中添加配置：
[mcp_servers.AskUserQuestionPlus]
url = "http://localhost:3456/mcp/"或者使用命令行：
codex mcp add AskUserQuestionsPlus --url http://localhost:3456/mcp/Gemini CLI
gemini mcp add AskUserQuestionPlus http://localhost:3456/mcp -s user --transport http
⚠️ 注意：如果遇到[Error: Unrecognized key(s) in object: 'type']错误 (参见issue #15449)：
请在~/.gemini/settings.json中删除type字段
或等待 gemini cliv0.23.0发布
🕹️ 使用方法
基本流程
启动与 Claude Code/Codex/Gemini 的对话。
模型调用工具：例如
使用 ask_user_question_plus 工具问我 3 个问题。浏览器自动打开问卷界面。
使用键盘（方向键、Space、Enter）或鼠标回答问题。
提交后浏览器标签页自动关闭，结果返回给模型。
键盘快捷键
快捷键 | 功能 |
| 在选项之间移动 / 滚动页面 |
| 在不同问题标签页之间切换 |
| 选中/取消选中当前选项 |
| 进入提交 Tab / 提交答案 |
🔧 工具定义 (Tools)
ask_user_question_plus
输入 Schema (Input):
{
questions: [
{
id: string; // 问题唯一标识
header: string; // 标签标题（推荐 ≤12 字符）
text: string; // 问题正文
type: "single" | "multiple"; // 问题类型：单选或多选
options: [
{
value: string; // 选项值
label: string; // 选项显示文本
description?: string; // 选项描述（可选）
recommended?: boolean;// 是否标记为推荐（可选）
}
]
}
] // 限制：1-20 个问题
}输出 Schema (Output):
{
"answers": {
"questionId1": {"value" : "", "other":""},
"questionId2": {"value" : "", "other":""},
}
}💡 提示：前端界面会自动为每个问题追加 "Other (自定义输入)" 选项。
🛠️ 开发指南
克隆项目
git clone https://github.com/JoJoJotarou/AskUserQuestionPlus.git && cd AskUserQuestionPlus安装依赖
npm install开发模式
npm run dev构建
npm run build
# npm start目录结构
ask-user-question-plus/
├── src/
│ ├── index.ts # 主入口文件
│ ├── ws-service.ts # WebSocket 服务逻辑
│ └── mcp-server.ts # MCP 服务器定义
├── public/
│ └── index.html # 前端 Web 界面
├── dist/ # 编译输出
└── package.json🤝 贡献
欢迎提交 Issues 或 Pull Requests 来改进这个项目。
📄 许可证
🔗 相关链接
✨ Features
🎨 Beautiful Interface: Replicates the Claude Code AskUserQuestions style with support for Dark/Light themes.
⌨️ Full Keyboard Control: Seamless navigation using Arrow keys, Tab, Space, and Enter.
📊 Rich Interactions: Supports single choice, multiple choice, recommended options, and custom input ("Other").
🔄 Real-time Communication: WebSocket-based messaging for instant feedback.
⏱️ Timeout Protection: Configurable session timeout (Default: 10 minutes).
📈 Scalable: Supports 1 to 20 questions with unlimited options per question.
🚀 Deployment
Startup Parameters
Argument | Description | Default | Example |
| Session timeout in milliseconds | 600000 (10 mins) |
|
| Server port | 3456 |
|
Foreground
npx ask-user-question-plus
# Custom port and timeout
npx ask-user-question-plus -- --port=3456 --timeout=600000Background (Recommended)
Using pm2
Install pm2 first:
npm install -g pm2
pm2 start "npx ask-user-question-plus" --name ask-user-question-plus-service
# With arguments
pm2 start "npx ask-user-question-plus -- --port=3456 --timeout=600000" --name ask-user-question-plus-service
# Stop service
pm2 stop ask-user-question-plus-service
# Windows
pm2 start cmd --name ask-user-question-plus-service -- /c npx ask-user-question-pluUsing Docker
docker compose up -d⚙️ Configuration
Claude Code
claude mcp add -s user -t http AskUserQuestionPlus http://localhost:3456/mcpCodex
Add to ~/.codex/config.toml:
[mcp_servers.AskUserQuestionPlus]
url = "http://localhost:3456/mcp/"Or via CLI:
codex mcp add AskUserQuestionsPlus --url http://localhost:3456/mcp/Gemini CLI
gemini mcp add AskUserQuestionPlus http://localhost:3456/mcp -s user --transport http
⚠️ Note: If you encounter[Error: Unrecognized key(s) in object: 'type'](Issue #15449):
Remove thetypefield in~/.gemini/settings.json.
Or wait for gemini cliv0.23.0.
🕹️ Usage
Basic Workflow
Start a conversation with Claude, Codex, or Gemini.
Ask the model to use the tool: e.g., "Use ask_user_question_plus to ask me 3 questions."
A browser tab will automatically open with the questionnaire.
Answer using your keyboard (Arrows, Space, Enter) or mouse.
Upon submission, the tab closes, and answers are sent back to the model.
Keyboard Shortcuts
Shortcut | Function |
| Move between options / Scroll |
| Switch between question tabs |
| Select/Deselect option |
| Submit Tab / Submit answers |
🔧 Tools Definition
ask_user_question_plus
Input Schema:
{
questions: [
{
id: string; // Unique identifier
header: string; // Tab header (Rec. ≤12 chars)
text: string; // Question text
type: "single" | "multiple"; // Question type
options: [
{
value: string; // Option value
label: string; // Option label
description?: string; // Option description (optional)
recommended?: boolean;// Recommended flag (optional)
}
]
}
] // Limit: 1-20 questions
}Output Schema:
{
"answers": {
"questionId1": { "value": "", "other": "" },
"questionId2": { "value": "", "other": "" }
}
}💡 Tip: The "Other" (custom input) option is automatically added by the frontend.
🛠️ Development
Clone
git clone https://github.com/JoJoJotarou/AskUserQuestionPlus.git && cd AskUserQuestionPlusInstall Dependencies
npm installRun Dev Mode
npm run devBuild
npm run build
# npm start🤝 Contribution
Contributions are welcome! Please submit Issues or Pull Requests.
📄 License
🔗 Related Links
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/JoJoJotarou/AskUserQuestionPlus'
If you have feedback or need assistance with the MCP directory API, please join our Discord server