MCP反馈增强
🌐 Language / 语言切换： 英语 | 繁体中文 | 简体中文
增强型分叉： 你为什么这么担心？ UI设计参考： sanshao85/mcp反馈采集器
🎯 核心概念
这是一个 MCP服务器 这确立了 面向反馈的开发工作流程，提供 Web UI和桌面应用程序 双界面选项，完美适应本地， SSH远程环境，以及 WSL（Linux的Windows子系统）环境通过引导人工智能与用户确认而不是进行推测性操作，它可以将多个工具调用合并为一个面向反馈的请求，从而大大降低平台成本并提高开发效率。
🌐 双接口架构优势：
- 🖥️ 桌面应用程序：原生跨平台桌面体验，支持Windows、macOS、Linux
- 🌐 Web用户界面：不需要GUI依赖关系，适用于远程和WSL环境
- 🔧 灵活部署：根据环境要求选择最合适的接口模式
- 📦 统一功能：两个接口提供完全相同的功能体验
🖥️ 桌面应用程序： v2.5.0引入了基于Tauri框架的跨平台桌面应用程序支持，支持Windows、macOS和Linux平台，具有原生桌面体验。
支持的平台： 光标 | 克莱恩 | 帆板运动 | 增强 | 崔
🔄 工作流程
- AI呼叫 →
mcp-feedback-enhanced工具 - 界面启动 → 自动打开桌面应用程序或浏览器界面（基于配置）
- 智能交互 → 提示选择、文本输入、图像上传、自动提交
- 实时反馈 → WebSocket连接立即向AI传递信息
- 会话跟踪 → 自动记录会话历史和统计信息
- 流程继续 → AI根据反馈调整行为或结束任务
🌟 主要特点
🖥️ 双接口支持
- 桌面应用程序：基于Tauri的跨平台原生应用程序，支持Windows、macOS、Linux
- Web UI界面：适用于远程和WSL环境的轻量级浏览器界面
- 自动环境检测：智能识别SSH Remote、WSL和其他特殊环境
- 统一功能体验：两个接口提供完全相同的功能
📝 智能工作流
- 及时管理：用于常见提示、使用统计、智能排序的CRUD操作
- 自动定时提交：1-86400秒灵活定时器，支持暂停、恢复、取消，带有新的暂停/恢复按钮控件
- 自动命令执行 （v2.6.0）：创建新会话或提交后自动执行预设命令，以提高开发效率
- 会话管理和跟踪：本地文件存储、隐私控制、历史导出（支持JSON、CSV、Markdown格式）、实时统计、灵活的超时设置
- 连接监控：WebSocket状态监控、自动重新连接、质量指示器
- AI工作总结Markdown显示：支持丰富的Markdown语法呈现，包括标题、粗体文本、代码块、列表、链接和其他格式，以增强内容的可读性
🎨 现代体验
- 响应式设计：适应不同的屏幕大小，模块化JavaScript架构
- 音频通知：内置多种音效，自定义音频上传支持，音量控制
- 系统通知 （v2.6.0）：重要事件的系统级实时警报（如自动提交、会话超时）
- 智能存储器：输入框高度记忆，一键复制，持久设置
- 多语言支持：繁体中文、英文、简体中文、即时切换
🖼️ 图片与媒体
- 完整格式支持：PNG、JPG、JPEG、GIF、BMP、WebP
- 方便上传：拖放文件、剪贴板粘贴（Ctrl+V）
- 无限制处理：支持任意尺寸图像，自动智能处理
🌐 界面预览
Web UI界面（v2.5.0-桌面应用程序支持）
📱 Click to view complete interface screenshots
*Web UI界面-支持桌面应用程序和Web界面，提供提示管理、自动提交、会话跟踪等智能功能*
桌面应用程序界面（v2.5.0新功能）
*桌面应用程序-基于Tauri框架的原生跨平台桌面应用程序，支持Windows、macOS、Linux，功能与Web UI完全相同*
快捷方式支持
Ctrl+Enter（Windows/Linux）/Cmd+Enter（macOS）：提交反馈（支持主键盘和数字键盘）Ctrl+V（Windows/Linux）/Cmd+V（macOS）：直接粘贴剪贴板图像Ctrl+I（Windows/Linux）/Cmd+I（macOS）：快速聚焦输入框（谢谢@penn201500）
🚀 快速开始
1.安装和测试
# Install uv (if not already installed)
pip install uv2.配置MCP
基本配置 （适合大多数用户）：
{
"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": {
"MCP_DEBUG": "false",
"MCP_WEB_HOST": "127.0.0.1",
"MCP_WEB_PORT": "8765",
"MCP_LANGUAGE": "en"
},
"autoApprove": ["interactive_feedback"]
}
}
}桌面应用程序配置 （v2.5.0新功能-使用本机桌面应用程序）：
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_HOST": "127.0.0.1",
"MCP_WEB_PORT": "8765",
"MCP_DEBUG": "false"
},
"autoApprove": ["interactive_feedback"]
}
}
}配置文件示例:
- 桌面模式： 示例/mcp-config-desktop.json
- Web模式： 示例/mcp-config.web.json
3.快速工程设置
为了获得最佳结果，请将以下规则添加到您的AI助手中：
# MCP Interactive Feedback Rules
follow mcp-feedback-enhanced instructions⚙️ 高级设置
环境变量
| 变量 | 目的 | 值 | 默认值 |
|---|---|---|---|
MCP_DEBUG | 调试模式 | true/false | false |
MCP_WEB_HOST | Web UI主机绑定 | IP地址或主机名 | 127.0.0.1 |
MCP_WEB_PORT | Web UI端口 | 1024-65535 | 8765 |
MCP_DESKTOP_MODE | 桌面应用程序模式 | true/false | false |
MCP_LANGUAGE | 强制UI语言 | zh-TW/zh-CN/en | 自动检测 |
MCP_WEB_HOST 解释:
127.0.0.1（默认）：仅本地访问，更高的安全性0.0.0.0：允许远程访问，适用于SSH远程开发环境
MCP_LANGUAGE 解释:
- 用于强制界面语言，覆盖自动系统检测
- 支持的语言代码：
- zh-TW：繁体中文 - zh-CN：简体中文 - en：英语
- 语言检测优先级：
1. 用户在界面中保存的语言设置（最高优先级） 1. MCP_LANGUAGE 环境变量 1. 系统环境变量（LANG、LC_ALL等） 1. 系统默认语言 1. 回退到默认语言（繁体中文）
测试选项
# Version check
uvx mcp-feedback-enhanced@latest version # Check version
# Interface testing
uvx mcp-feedback-enhanced@latest test --web # Test Web UI (auto continuous running)
uvx mcp-feedback-enhanced@latest test --desktop # Test desktop application (v2.5.0 new feature)
# Debug mode
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
# Specify language for testing
MCP_LANGUAGE=en uvx mcp-feedback-enhanced@latest test --web # Force English interface
MCP_LANGUAGE=zh-TW uvx mcp-feedback-enhanced@latest test --web # Force Traditional Chinese
MCP_LANGUAGE=zh-CN uvx mcp-feedback-enhanced@latest test --web # Force Simplified Chinese开发人员安装
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync本地测试方法
# Functional testing
make test-func # Standard functional testing
make test-web # Web UI testing (continuous running)
make test-desktop-func # Desktop application functional testing
# Or use direct commands
uv run python -m mcp_feedback_enhanced test # Standard functional testing
uvx --no-cache --with-editable . mcp-feedback-enhanced test --web # Web UI testing (continuous running)
uvx --no-cache --with-editable . mcp-feedback-enhanced test --desktop # Desktop application testing
# Desktop application build (v2.5.0 new feature)
make build-desktop # Build desktop application (debug mode)
make build-desktop-release # Build desktop application (release mode)
make test-desktop # Test desktop application
make clean-desktop # Clean desktop build artifacts
# Unit testing
make test # Run all unit tests
make test-fast # Fast testing (skip slow tests)
make test-cov # Test and generate coverage report
# Code quality checks
make check # Complete code quality check
make quick-check # Quick check and auto-fix测试说明
- 功能测试：测试完整的MCP工具功能工作流程
- 单元测试：测试单个模块功能
- 覆盖率测试：生成HTML覆盖率报告
htmlcov/目录 - 质量检查：包括装订、格式化、类型检查
🆕 版本历史记录
📋 完整版本历史记录： RELEASE_NOTE/CHANGELOG.en.md
最新版本亮点（v2.6.0）
- 🚀 自动命令执行：创建新会话或提交后自动执行预设命令，提高工作流效率
- 📊 会话导出功能：支持将会话记录导出为多种格式，以便于共享和归档
- ⏸️ 自动提交控制：添加了暂停和恢复按钮，以便更好地控制自动提交时间
- 🔔 系统通知：具有实时警报的重要事件的系统级通知
- ⏱️ 会话超时优化：重新设计了会话管理，提供了更灵活的配置选项
- 🌏 I18n增强：重构的国际化架构，对通知提供全面的多语言支持
- 🎨 UI简化：大大简化了用户界面，改善了用户体验
🐛 常见问题
🌐 SSH远程环境问题
Q： 浏览器无法在SSH远程环境中启动或访问 A： 有两种解决方案可供选择：
解决方案1：环境变量设置（v2.5.5推荐） 集 "MCP_WEB_HOST": "0.0.0.0" 在MCP配置中允许远程访问：
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_WEB_HOST": "0.0.0.0",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"]
}
}
}然后在本地浏览器中打开： http://[remote-host-IP]:8765
解决方案2:SSH端口转发（传统方法）
- 使用默认配置(
MCP_WEB_HOST:127.0.0.1) - 设置SSH端口转发：
- VS代码远程SSH：新闻 Ctrl+Shift+P → “转发端口”→ Enter 8765 - 游标SSH远程：手动添加端口转发规则（端口8765）
- 在本地浏览器中打开：
http://localhost:8765
详细解决方案请参考： SSH远程环境使用指南
Q： 为什么我没有收到新的MCP反馈？ A： 可能是WebSocket连接问题。 解决方案：直接刷新浏览器页面。
Q： 为什么不叫MCP？ A： 请确认MCP工具状态显示绿灯。 解决方案：反复打开/关闭MCP工具，等待几秒钟以重新连接系统。
Q： Augment无法启动MCP A. 解决方案：完全关闭并重新启动VS Code或Cursor，重新打开项目。
🔧 一般问题
Q： 如何使用桌面应用程序？ A： v2.5.0引入了跨平台桌面应用程序支持。集 "MCP_DESKTOP_MODE": "true" 在MCP配置中启用：
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"]
}
}
}配置文件示例: 示例/mcp-config-desktop.json
Q： 如何使用旧版PyQt6 GUI界面？ A： v2.4.0完全删除了PyQt6 GUI依赖项。要使用旧版GUI，请指定v2.3.0或更早版本： uvx mcp-feedback-enhanced@2.3.0 备注：旧版本不包括新功能（提示管理、自动提交、会话管理、桌面应用程序等）。
Q： 出现“意外令牌'D'”错误 A： 调试输出干扰。集 MCP_DEBUG=false 或者删除环境变量。
Q： 汉字乱码文本 A： 已在v2.0.3中修复。更新到最新版本： uvx mcp-feedback-enhanced@latest
Q： 多屏幕环境中的窗口消失或定位错误 A： 已在v2.1.1中修复。首选⚙️ 设置”选项卡，选中“始终在主屏幕中心显示窗口”以解决。特别适用于T形屏幕排列和其他复杂的多屏幕配置。
Q： 图像上传失败 A： 检查文件格式（PNG/JPG/JPEG/GIF/BMP/WebP）。系统支持任何大小的图像文件。
Q： Web UI无法启动 A： 检查防火墙设置或尝试使用其他端口。
Q： UV缓存占用太多磁盘空间 A： 由于频繁使用 uvx 命令、缓存可能累积到数十GB。建议定期清理：
# View cache size and detailed information
python scripts/cleanup_cache.py --size
# Preview cleanup content (no actual cleanup)
python scripts/cleanup_cache.py --dry-run
# Execute standard cleanup
python scripts/cleanup_cache.py --clean
# Force cleanup (attempts to close related programs, solving Windows file occupation issues)
python scripts/cleanup_cache.py --force
# Or directly use uv command
uv cache clean有关详细说明，请参阅： 缓存管理指南
Q： AI模型无法解析图像 A： 各种AI模型（包括Gemini Pro 2.5、Claude等）在图像解析中可能存在不稳定性，有时会正确识别，有时无法解析上传的图像内容。这是人工智能视觉理解技术的一个已知局限性。建议：
- 确保良好的图像质量（高对比度、清晰的文本）
- 尝试多次上传，重试通常成功
- 如果解析仍然失败，请尝试调整图像大小或格式
🙏 致谢
🌟 支持原作者
法比奥 费雷拉 - X@fabiomlferreira 原始项目： noopstudio/交互式反馈mcp
如果你觉得它有用，请：
设计灵感
三沙85 - mcp反馈收集器
贡献者
2015年1月 -
- 🎯 自动对焦输入框功能(公关#39)
leo108 -
- 🌐 SSH远程开发支持(
MCP_WEB_HOST环境变量）(产品编号113)
阿尔桑 -
- 🍎 macOS PyO3编译配置支持(产品编号93)
佛罗伦萨 -
- 📝 工具文档优化（LLM指令移至docstring）(产品编号105)
社区支持
- 不一致： https://discord.gg/Gur2V67
- 问题：
📄 许可证
MIT许可证-请参阅 许可证 详细信息文件
📈 星迹
______________________________________________________________________
🌟 欢迎来到Star，与更多开发者分享！