Minidoracat/mcp-feedback-enhanced

什么是 MCP Feedback Enhanced？

MCP Feedback Enhanced 是一个 服务器端工具，可接入 Model Context Protocol (MCP) 生态系统。它为长时间运行的 AI 任务添加了 人机交互式反馈 UI。当 AI 模型（例如 Cursor、Cline、Windsurf、Augment、Trae）需要确认或澄清时，模型会调用 mcp-feedback-enhanced 命令。该工具随后启动一个 Web UI（或可选的 Tauri 桌面应用），用户可在其中查看请求、输入回复、上传图片，或让计时器自动提交。回复通过 WebSocket 发送回 AI，使模型能基于新信息继续执行。

该项目是 Minidoracat 维护的原始 interactive-feedback-mcp 实现的 分支。它专注于安全性（移除不安全的命令执行、强化 WebSocket 原始检查），并确保 UI 在 SSH 远程、WSL 和本地环境中稳定运行。

---

核心理念

理念	为何重要
以反馈为导向的工作流	插入明确的人类检查点，减少长时间 AI 驱动流程中的偏差和返工。
双界面设计	轻量级浏览器 UI 可在任何地方运行；Tauri 桌面包装器提供 Windows/macOS/Linux 的原生外观应用（仅维护，v3 中将被移除）。
环境感知	自动检测 SSH 远程会话和 WSL，无需额外配置即可选择合适的 UI 模式。
会话追踪	将每个反馈会话本地保存（JSON/CSV/Markdown），并显示实时统计，便于审计或共享结果。
安全优先更新	v2.6.1 移除了危险的“自动命令”功能，并验证 WebSocket Origin 头，修复了两个高危漏洞。

---

谁会使用它？

• 开发者：构建需要偶尔用户确认的 AI 辅助工具（如代码生成助手、数据标注流水线）的人。
• 团队：使用 MCP 兼容客户端（Cursor、Cline 等）并希望在本地、远程或容器化环境中保持一致 UI 的人。
• 研究人员：原型化交互式 LLM 工作流，需要快速捕捉和重放人类输入的人。

---

主要功能（截至 v2.6.0）

• Web UI – 默认运行在 http://127.0.0.1:8765，无 GUI 依赖，支持 SSH 端口转发。
• 桌面应用 – 同一 UI 的 Tauri 包装（仅维护，v3 中将被移除）。
• 提示管理 – 创建、编辑、删除可重用提示；查看使用统计；自动排序。
• 自动定时提交 – 可配置计时器（1 s – 86400 s），支持暂停/继续/取消控制。
• 会话历史 – 本地文件存储，支持导出为 JSON/CSV/Markdown，实时统计。
• WebSocket 连接监控 – 显示状态、自动重连、质量指示器。
• 富 Markdown 显示 – AI 摘要以标题、代码块、列表等格式渲染。
• 音频与系统通知 – 可选音效和操作系统级警报，用于自动提交或超时等事件。
• 国际化 – UI 支持英文、繁体中文、简体中文；可通过 MCP_LANGUAGE 强制指定语言。
• 图像支持 – 支持任意大小的 PNG/JPG/GIF/BMP/WebP 图片拖拽上传或剪贴板粘贴。

---

快速入门（快速运行）

# 安装 uv 运行器（若尚未安装）
pip install uv

# 运行最新版本（撰写时为 v2.6.1）
uvx mcp-feedback-enhanced@latest

该命令启动 MCP 服务器，打开 Web UI，并打印 URL（例如 http://127.0.0.1:8765）。在浏览器中访问该 URL，或在 MCP 配置中设置 "MCP_DESKTOP_MODE": "true" 以打开原生桌面窗口。

---

配置快照

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "command": "uvx",
      "args": ["mcp-feedback-enhanced@latest"],
      "timeout": 600,
      "env": {
        "MCP_DEBUG": "false",
        "MCP_WEB_HOST": "127.0.0.1",
        "MCP_WEB_PORT": "8765",
        "MCP_LANGUAGE": "en"
      },
      "autoApprove": ["interactive_feedback"]
    }
  }
}

若希望在 v2.8 之后仍保留桌面应用，请将 uvx mcp-feedback-enhanced@latest 替换为固定版本（如 @2.8.0）。

---

安全与维护说明

• v2.6.1 移除了旧的“自动命令”功能，该功能曾允许未经认证的 WebSocket 客户端执行任意 shell 命令。服务器现在仅提供 UI 和 WebSocket，不再支持命令执行。
• WebSocket 原始验证 防止其他网站劫持连接。
• 桌面二进制文件较大（约占包大小的 80%），将在 v3 中弃用；长期推荐使用 Web UI 作为接口。
• 原始“节省配额”说法（合并多次往返）在 Cursor 于 2025 年 6 月切换为基于 token 的计费后已不再成立。该工具的价值现在在于 人类检查点，而非成本节约。

---

更多学习资源

• 完整更新日志 – RELEASE_NOTES/CHANGELOG.en.md
• 安全详情 – SECURITY.md
• SSH 远程使用指南 – docs/en/ssh-remote/browser-launch-issues.md
• 示例配置文件 – examples/mcp-config-web.json 和 examples/mcp-config-desktop.json

---

总结

MCP Feedback Enhanced 是一个 MCP 兼容服务器，为 AI 模型在长时间任务中提供基于 Web（或可选桌面）的 UI，供人类快速反馈。它可在本地、SSH 远程和 WSL 环境中运行，支持会话追踪、图像和 Markdown，且近期已针对命令执行和 WebSocket 劫持漏洞进行了加固。当您需要为任何 MCP 兼容 AI 客户端提供可靠、语言感知的人类介入检查点时，可使用它。