MCP增强反馈服务器 (mcp-feedback-enhanced)

项目概述

mcp-feedback-enhanced 是一个增强版的 MCP (Model Context Protocol) 服务器，专门为AI辅助开发工具中的交互式用户反馈和命令执行而设计。该项目支持双界面模式（Web UI 和桌面应用程序），具有智能环境检测功能和跨平台兼容性。

核心特点

• 双界面支持: 支持Web UI和原生桌面应用程序
• 智能环境检测: 自动检测运行环境并选择最适合的界面模式
• 跨平台兼容: 支持Windows、macOS、Linux系统
• 成本优化: 通过引导AI与用户确认而不是进行投机性操作，可以将多达25个工具调用整合为单个反馈导向的请求，显著降低平台成本

支持的平台

支持的AI开发平台包括：Cursor、Cline、Windsurf

工作原理

项目的工作流程如下：

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

主要功能特性

界面模式

Qt GUI界面

• 本地环境的原生体验
• 模块化重构设计
• 适合本地开发环境

Web UI界面

• 现代化界面设计，适合远程SSH环境
• 全新架构设计
• 响应式布局，适应不同屏幕尺寸

核心功能

图片处理功能

• 格式支持: PNG, JPG, JPEG, GIF, BMP, WebP
• 上传方式: 拖拽文件 + 剪贴板粘贴 (Ctrl+V)
• 自动处理: 智能压缩确保符合1MB限制

多语言支持

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

快捷键支持

• Ctrl+Enter: 提交反馈（支持主键盘和数字小键盘）
• Ctrl+V: 直接粘贴剪贴板图片

安装和配置

快速安装

# 安装 uv (如果还没安装)
pip install uv

# 快速测试
uvx mcp-feedback-enhanced@latest test

基本配置

在AI助手（如Cursor）中添加以下配置：

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

高级配置

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

环境变量配置

变量名	用途	取值	默认值
FORCE_WEB	强制使用Web UI	true/false	false
MCP_DEBUG	调试模式	true/false	false
INCLUDE_BASE64_DETAIL	图片完整Base64	true/false	false

使用建议

为了获得最佳效果，建议在AI助手中添加以下规则：

# MCP 交互反馈规则
1. 在任何过程、任务或对话中，无论是询问、回应还是完成阶段任务，都必须调用 MCP mcp-feedback-enhanced。
2. 收到用户反馈时，如果反馈内容不为空，必须再次调用 MCP mcp-feedback-enhanced 并根据反馈调整行为。
3. 只有当用户明确表示"结束"或"不需要更多交互"时，才能停止调用 MCP mcp-feedback-enhanced，然后流程完成。
4. 除非收到结束命令，所有步骤都必须重复调用 MCP mcp-feedback-enhanced。

测试方法

版本检查

uvx mcp-feedback-enhanced@latest version

界面特定测试

# Qt GUI 快速测试
uvx mcp-feedback-enhanced@latest test --gui

# Web UI 测试（自动持续运行）
uvx mcp-feedback-enhanced@latest test --web

# 调试模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test

本地开发测试

# 克隆项目
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync

# 方法1：标准测试（推荐）
uv run python -m mcp_feedback_enhanced test

# 方法2：完整测试套件
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测试

版本历史和主要更新

最新特性（v2.6.0及以上）

• 完整重构: GUI和Web UI采用模块化架构
• 集中管理: 重组文件夹结构，提升可维护性
• 界面优化: 现代化设计和改进的用户体验
• macOS界面优化: 专门针对macOS用户体验的改进
• 功能增强: 新的设置选项和自动关闭页面功能

核心改进

• 语言切换: 修复Web UI切换语言时内容更新问题
• 关于页面: 添加包含版本信息、项目链接和致谢的关于页面
• 增强快捷键: Ctrl+Enter支持数字小键盘
• 智能图片粘贴: Ctrl+V直接粘贴剪贴板图片
• 多语言架构重构: 动态加载和模块化语言文件组织

常见问题解答

Q: 出现"Unexpected token 'D'"错误

A: 调试输出干扰。设置 MCP_DEBUG=false 或移除环境变量。

Q: 中文字符乱码

A: v2.0.3版本已修复。更新到最新版本：uvx mcp-feedback-enhanced@latest

Q: 图片上传失败

A: 检查文件大小（≤1MB）和格式（PNG/JPG/GIF/BMP/WebP）。

Q: Web UI无法启动

A: 设置 FORCE_WEB=true 或检查防火墙设置。

Q: Gemini Pro 2.5无法解析图片

A: 已知问题。Gemini Pro 2.5可能无法正确解析上传的图片内容。测试显示Claude-4-Sonnet可以正确分析图片。建议使用Claude模型获得更好的图片理解能力。

项目价值

这个项目的核心价值在于解决AI辅助开发中的一个关键问题：避免AI进行昂贵的投机性操作。通过建立人机交互反馈循环，用户可以在AI执行复杂或成本高昂的操作之前提供确认和指导，从而：

1. 降低成本: 减少不必要的API调用
2. 提高效率: 避免错误的操作路径
3. 增强控制: 用户保持对开发过程的主导权
4. 改善体验: 更流畅的人机协作开发流程