项目简介

MCP用户交互回馈增强版是一个基于 Model Context Protocol (MCP) 的应用后端（MCP服务器），旨在为支持MCP协议的LLM客户端（如Cursor、Cline、Windsurf等）提供丰富的用户交互回馈功能。它允许AI在执行复杂任务时，向用户征求意见、获取反馈、接收指令或图片，从而实现高效的“人机协作”开发流程。

主要功能点

智能双界面支持: 根据运行环境自动选择最优界面。
- 本地GUI: 在本地桌面环境提供原生图形界面。
- 远程WebUI: 在SSH远程或无头环境提供现代化的Web界面，方便远程访问。
多模态用户回馈: 不仅支持文字输入，还支持用户上传图片作为反馈或上下文。
命令执行功能: 用户可以在回馈界面中直接执行终端命令，并将输出返回给AI，用于验证或提供更多信息。
国际化支持: 提供多语言界面（英语、繁体中文、简体中文），并支持自动检测和手动切换。
模块化架构: 代码结构清晰，易于維護和擴展。

安装步骤

此项目推荐使用 'uvx' 命令进行快速安装和运行，无需手动管理虚拟环境。

安装 uv (如果尚未安装):
```
pip install uv
```
安装并测试运行:
```
uvx mcp-feedback-enhanced@latest test
```
这条命令会自动下载并运行最新版本的 'mcp-feedback-enhanced'，并执行一个简单的自檢測試。

服务器配置

要讓您的MCP客户端（如Cursor）使用此服务器，需要在客户端的MCP配置文件（通常是'mcp.json'或类似的文件，具体位置请参考您的客户端文档）中添加以下配置项：

{
  "mcpServers": {
    "mcp-feedback-enhanced": { // 服务器的唯一名称，可自定义
      "command": "uvx", // 启动服务器的可执行文件或命令
      "args": ["mcp-feedback-enhanced@latest"], // 启动命令的参数，这里指定运行最新版本
      "timeout": 600, // 客户端等待服务器响应的超时时间（秒），建议设置为600或更高
      "autoApprove": ["interactive_feedback", "get_system_info"] // 客户端可以自动调用的工具列表
      // 可选参数:
      // "env": { // 设置环境变量，例如强制使用Web UI 或启用调试模式
      //   "FORCE_WEB": "true",
      //   "MCP_DEBUG": "false"
      // }
    }
  }
}

基本使用方法

配置完成后，在支持MCP协议的LLM客户端中：

当AI助手需要从您那里获取交互式回馈、需要您执行命令验证结果、或者需要您提供图片上下文时，AI会通过MCP协议自动调用'mcp-feedback-enhanced'服务器的'interactive_feedback'工具。
'mcp-feedback-enhanced' 服务器将根据您的运行环境（本地或远程）自动彈出或在浏览器中打開回饋界面。
您可以在弹出的界面中输入文字回馈、上传图片或执行命令。
完成操作后，点击“提交回馈”按钮（或使用快捷键 Ctrl+Enter），回饋数据将通过MCP协议发送回AI助手。
AI助手接收到您的回饋后，将根据这些信息调整后续的生成或操作。
如果需要取消回馈，点击“取消”按钮（或使用快捷键 Escape）。

AI助手需要通过Prompt Engineering被引导来调用'interactive_feedback'工具，以有效利用此服务器的功能。建议在AI助手的系统指令中加入相关调用规则。

关键词

信息