MCP增强反馈

MCPforWork/feedback-enhanced

6 Stars 2.3k 次浏览更新于 2026-08-23

该项目是一个MCP服务器，旨在建立以反馈为中心的开发工作流程，支持本地、SSH远程和WSL环境。通过将多个工具调用整合为一个以反馈为中心的请求，它旨在降低平台成本并提高开发效率。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "args": [
        "mcp-feedback-enhanced@latest"
      ],
      "autoApprove": [
        "interactive_feedback"
      ],
      "command": "uvx",
      "env": {
        "FORCE_WEB": "true",
        "MCP_DEBUG": "false"
      },
      "timeout": 600
    }
  }
}

该服务需要配置环境变量：FORCE_WEB、MCP_DEBUG

服务介绍

MCP 反馈增强版

🌐 语言切换: English | 繁體中文 | 简体中文

原始作者: Fábio Ferreira | 原始项目 ⭐
增强分支: Minidoracat
UI 设计参考: sanshao85/mcp-feedback-collector

🎯 核心概念

这是一个 MCP 服务器，它建立了以反馈为导向的开发工作流，完美适应本地环境、SSH 远程环境（Cursor SSH 远程、VS Code 远程 SSH）和WSL（Windows Subsystem for Linux）环境。通过引导 AI 确认用户操作而不是进行推测性操作，它可以将多个工具调用合并为一个以反馈为导向的请求，从而大幅降低平台成本并提高开发效率。

支持的平台: Cursor | Cline | Windsurf | Augment | Trae

🔄 工作流程

AI 调用 → mcp-feedback-enhanced
环境检测 → 自动选择合适的界面
用户交互 → 命令执行、文本反馈、图片上传
反馈传递 → 信息返回给 AI
过程继续 → 根据反馈调整或结束

🌟 主要特性

🖥️ 双界面系统

Qt GUI: 本地环境的原生体验，模块化重构设计
Web UI: 适用于远程 SSH 和 WSL 环境的现代界面，全新架构
智能切换: 自动检测环境（本地/远程/WSL）并选择最佳界面

🎨 全新界面设计 (v2.1.0)

模块化架构: GUI 和 Web UI 都采用模块化设计
集中管理: 重新组织文件夹结构以便于维护
现代主题: 改进视觉设计和用户体验
响应式布局: 适应不同的屏幕尺寸和窗口大小

🖼️ 图片支持

格式支持: PNG, JPG, JPEG, GIF, BMP, WebP
上传方法: 拖放文件 + 剪贴板粘贴 (Ctrl+V)
自动处理: 智能压缩以确保不超过 1MB 的限制

🌏 多语言支持

三种语言: 英语、繁体中文、简体中文
智能检测: 根据系统语言自动选择
实时切换: 在界面内直接更改语言

✨ WSL 环境支持 (v2.2.5)

自动检测: 智能识别 WSL（Windows Subsystem for Linux）环境
浏览器集成: 在 WSL 环境中自动启动 Windows 浏览器
多种启动方式: 支持 cmd.exe、powershell.exe、wslview 等浏览器启动方式
无缝体验: WSL 用户可以直接使用 Web UI 而无需额外配置

🌐 SSH 远程环境支持 (v2.3.0 新功能)

智能检测: 自动识别 SSH 远程环境（如 Cursor SSH 远程、VS Code 远程 SSH 等）
浏览器启动指南: 当浏览器无法自动启动时提供明确解决方案
端口转发支持: 完整的端口转发设置指南和故障排除
MCP 集成优化: 改进与 MCP 系统的集成，提供更稳定的连接体验
详细文档: SSH 远程环境使用指南
🎯 自动聚焦输入框: 窗口打开时自动聚焦到反馈输入框，提升用户体验（感谢 @penn201500）

🖥️ 界面预览

Qt GUI 界面（重构版本）

Qt GUI 界面 - 模块化重构，支持本地环境

Web UI 界面（重构版本）

Web UI 界面 - 全新架构，适合 SSH 远程环境

快捷键

Ctrl+Enter (Windows/Linux) / Cmd+Enter (macOS): 提交反馈（支持主键盘和数字键盘）
Ctrl+V (Windows/Linux) / Cmd+V (macOS): 直接粘贴剪贴板中的图片

🚀 快速开始

1. 安装与测试

bash

安装 uv（如果尚未安装）

pip install uv

快速测试

uvx mcp-feedback-enhanced@latest test

2. MCP 配置

基本配置（适用于大多数用户）:
json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}

高级配置（需要自定义环境）:
json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"FORCE_WEB": "true",
"MCP_DEBUG": "false"
},
"autoApprove": ["interactive_feedback"]
}
}
}

3. 提示工程设置

为了获得最佳效果，请将以下规则添加到您的 AI 助手中：

MCP 交互式反馈规则

在任何过程、任务或对话中，无论是提问、回应还是完成阶段任务，都必须调用 MCP mcp-feedback-enhanced。
收到用户反馈时，如果反馈内容不为空，必须再次调用 MCP mcp-feedback-enhanced，并根据反馈调整行为。
只有当用户明确表示“结束”或“不再需要交互”时，才能停止调用 MCP mcp-feedback-enhanced，然后过程才算完成。
除非收到结束命令，否则所有步骤都必须反复调用 MCP mcp-feedback-enhanced。
在完成任务之前，使用 MCP mcp-feedback-enhanced 向用户请求反馈。

⚙️ 高级设置

环境变量

变量	用途	值	默认值
`FORCE_WEB`	强制使用 Web UI	`true`/`false`	`false`
`MCP_DEBUG`	调试模式	`true`/`false`	`false`
`MCP_WEB_PORT`	Web UI 端口	`1024-65535`	`8765`

测试选项

bash

版本检查

uvx mcp-feedback-enhanced@latest version # 检查版本

界面特定测试

uvx mcp-feedback-enhanced@latest test --gui # 快速测试 Qt GUI
uvx mcp-feedback-enhanced@latest test --web # 测试 Web UI（自动连续运行）

调试模式

MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test

开发者安装

bash
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync

本地测试方法
bash

方法 1：标准测试（推荐）

uv run python -m mcp_feedback_enhanced test

方法 2：完整测试套件（macOS 和 Windows 开发环境）

uvx --with-editable . mcp-feedback-enhanced test

方法 3：界面特定测试

uvx --with-editable . mcp-feedback-enhanced test --gui # 快速测试 Qt GUI
uvx --with-editable . mcp-feedback-enhanced test --web # 测试 Web UI（自动连续运行）

测试说明

标准测试：完整的功能检查，适合日常开发验证
完整测试：对所有组件进行深度测试，适合发布前验证
Qt GUI 测试：快速启动并测试本地图形界面
Web UI 测试：启动 Web 服务器并保持运行，以进行完整的 Web 功能测试

🆕 版本历史📋 完整版本历史记录: RELEASE_NOTES/CHANGELOG.en.md

🐛 常见问题

🌐 SSH 远程环境问题

Q: 浏览器无法在 SSH 远程环境中启动
A: 这是正常行为。SSH 远程环境没有图形界面，需要手动在本地浏览器中打开。详细解决方案请参阅：SSH 远程环境使用指南

Q: 为什么我没有收到新的 MCP 反馈？
A: 可能存在 WebSocket 连接问题。解决方案: 仅需刷新浏览器页面。

Q: 为什么 MCP 没有被调用？
A: 请确认 MCP 工具状态显示为绿灯。解决方案: 反复切换 MCP 工具的开关状态，等待几秒钟让系统重新连接。

Q: Augment 无法启动 MCP
A: 解决方案: 完全关闭并重新启动 VS Code 或 Cursor，然后重新打开项目。

🔧 一般问题

Q: 出现 "Unexpected token 'D'" 错误
A: 调试输出干扰。设置 MCP_DEBUG=false 或移除该环境变量。

Q: 中文字符乱码
A: 该问题已在 v2.0.3 版本中修复。更新到最新版本: uvx mcp-feedback-enhanced@latest

Q: 多屏幕窗口消失或定位错误
A: 该问题已在 v2.1.1 版本中修复。转到 "⚙️ 设置" 标签页，勾选 "始终在主屏幕中心显示窗口" 以解决。特别适用于 T 形屏幕布局和其他复杂的多显示器配置。

Q: 图像上传失败
A: 检查文件大小（≤1MB）和格式（PNG/JPG/GIF/BMP/WebP）。

Q: Web UI 无法启动
A: 设置 FORCE_WEB=true 或检查防火墙设置。

Q: UV 缓存占用过多磁盘空间
A: 由于频繁使用 uvx 命令，缓存可能会累积到数十 GB。建议定期清理：
bash

检查缓存大小和详细信息

python scripts/cleanup_cache.py --size

预览清理内容（不实际清理）

python scripts/cleanup_cache.py --dry-run

执行标准清理

python scripts/cleanup_cache.py --clean

强制清理（尝试关闭相关进程，解决 Windows 文件锁定问题）

python scripts/cleanup_cache.py --force

或者直接使用 uv 命令

uv cache clean

详细说明请参阅：缓存管理指南

Q: AI 模型无法解析图像
A: 各种 AI 模型（包括 Gemini Pro 2.5、Claude 等）在图像解析方面可能存在不稳定性，有时能够正确识别，有时则无法解析上传的图像内容。这是 AI 视觉理解技术的一个已知限制。建议：

确保图像质量良好（高对比度、清晰的文字）
尝试多次上传，重试通常会成功
如果解析仍然失败，尝试调整图像大小或格式

🙏 致谢

🌟 支持原作者

Fábio Ferreira - X @fabiomlferreira
原始项目: noopstudios/interactive-feedback-mcp

如果您觉得有用，请：

⭐ 给原始项目点星
📱 关注原作者

设计灵感

sanshao85 - mcp-feedback-collector

贡献者penn201500 - GitHub @penn201500

🎯 自动聚焦输入框功能 (PR #39)

社区支持

Discord: https://discord.gg/Gur2V67
问题反馈: GitHub Issues

📄 许可证

MIT 许可证 - 详情请参见 LICENSE 文件

🌟 欢迎 Star 并分享给更多开发者！

查看源码项目主页