MCP用户反馈服务器
一种模型上下文协议（MCP）服务器，它提供了一种通过系统对话框请求用户反馈的工具。
特性
- 跨平台对话支持（macOS、Linux、Windows）
- 单一工具：
request_user_feedback - 本地系统对话集成
- 支持自定义标题和默认文本
- 与Cursor、Claude Desktop等MCP客户端轻松集成。
快速开始
与MCP客户端一起使用
此服务器设计用于MCP客户端。最简单的方法是直接从npm安装：
npx mcp-user-feedback-server@latest安装开发
npm install
npm run build命令行选项
服务器支持以下命令行选项：
| 选项 | 别名 | 描述 |
|---|---|---|
| --timeout | -t | 设置对话框超时时间（秒）（默认值：600秒/10分钟） |
例子：
# Set timeout to 5 minutes (300 seconds)
npx mcp-user-feedback-server --timeout 300
# Using the short form
npx mcp-user-feedback-server -t 300MCP客户端配置
光标IDE
将此添加到MCP服务器配置中的游标设置中：
{
"mcpServers": {
"user-feedback": {
"command": "npx",
"args": [
"-y",
"mcp-user-feedback-server@latest"
]
}
}
}要设置自定义超时时间，请执行以下操作：
{
"mcpServers": {
"user-feedback": {
"command": "npx",
"args": [
"-y",
"mcp-user-feedback-server@latest",
"--timeout",
"300"
]
}
}
}克劳德桌面
将此添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"user-feedback": {
"command": "npx",
"args": [
"-y",
"mcp-user-feedback-server@latest"
]
}
}
}其他MCP客户端
对于支持模型上下文协议的任何MCP客户端，您可以使用：
- 命令:
npx - 参数:
["-y", "mcp-user-feedback-server@latest"]
地方发展设置
如果你在本地开发，你也可以直接运行服务器：
{
"mcpServers": {
"user-feedback": {
"command": "node",
"args": ["/path/to/mcp-user-feedback-server/dist/index.js"]
}
}
}最佳实践：使用游标规则
此MCP服务器在与AI助手配置中的适当规则或提示结合使用时效果最佳。这确保了人工智能始终如一地使用反馈工具来验证其工作，而不是做出假设。
推荐光标规则
将此规则添加到您的游标配置中，以实现最佳的用户反馈集成：
**Feedback Protocol**
**Core Rule:** Always use the `request_user_feedback` tool to verify your work - never assume you got it right.
### **When to Request Feedback:**
1. **When You Need Clarification**
- If any part of the request is unclear or missing details
- Example: *"Should I focus more on [A] or [B] for this analysis?"*
2. **When You Complete a Task**
- After delivering any result, big or small
- Example: *"Here's the draft: [summary]. Does this meet your needs?"*
**How to Use the Tool Properly:**
- Always phrase requests clearly and specifically
- Offer options when possible (e.g., "Should I use approach X or Y?")
- Never proceed without getting explicit confirmation
**Golden Rule:** Your work isn't done until the user says "This is exactly what I needed." Keep improving until you hear those words.如何在游标中添加规则
- 打开光标IDE
- 首选 设置 > 规则与记忆 > 用户规则
- 添加上述反馈协议规则
- 保存配置
这确保了您的AI助手将：
- 要求不明确时要求澄清
- 在继续之前，验证已完成的工作
- 使用对话框获取实时反馈
- 跟进，直到您确认满意为止
工具：请求_用户_反馈
显示一个对话框，请求用户提供反馈。
参数
question（必填）：向用户显示的问题或提示title（可选）：对话框的标题defaultAnswer（可选）：输入字段中预先填写的默认文本
MCP客户端中的示例用法
在MCP客户端中配置后，您可以在对话中使用该工具：
示例1：简单问题
User: Ask me what my favorite programming language is
AI: I'll ask you about your favorite programming language.
[AI uses request_user_feedback tool with question: "What is your favorite programming language?"]
[Dialog box appears on your screen]
[You type "TypeScript" and click OK]
AI: Thanks! You mentioned that TypeScript is your favorite programming language.示例2：具有自定义标题和默认标题
User: Get my preferred email for notifications
AI: Let me ask for your preferred notification email.
[AI uses request_user_feedback tool with:
question: "Please enter your preferred email for notifications:"
title: "Email Settings"
defaultAnswer: "user@example.com"]
[Dialog box appears with the title "Email Settings"]
[You modify the default email and submit]
AI: I've noted your preferred email for notifications.刀具参数
{
"question": "What is your favorite color?",
"title": "User Preference",
"defaultAnswer": "Blue"
}平台特定实施
- macOS：使用AppleScript
osascript - Linux：用途
zenity,kdialog,yad，或xmessage（需要GUI环境） - 视窗：使用PowerShell或VBScript（回退）
系统要求
macOS
- 不需要额外的依赖关系
Linux
- 需要以下之一：
zenity（GNOME/GTK），kdialog（KDE），yad，或xmessage - 安装zenity：
sudo apt-get install zenity（Ubuntu/Debian）
视窗
- 不需要额外的依赖关系
错误处理
该工具可处理各种错误情况：
- 用户取消
- 对话超时
- 缺少GUI环境
- 特定于平台的对话失败
发展
项目结构：
src/
├── index.ts # Main MCP server
├── dialog.ts # Cross-platform dialog manager
docs/
├── FEEDBACK_PROTOCOL.md # Feedback protocol documentation许可证
麻省理工学院
从“fs”导入{read_file}；