mcp-feedback-enhanced 部署完全手册：从本地到云端的实战指南

mcp-feedback-enhanced 部署完全手册：从本地到云端的实战指南

【免费下载链接】mcp-feedback-enhancedInteractive User Feedback MCP项目地址: https://gitcode.com/gh_mirrors/mc/mcp-feedback-enhanced

MCP Feedback Enhanced 是一个强大的交互式用户反馈系统，它通过 Model Context Protocol (MCP) 协议建立反馈导向的开发工作流，提供 Web UI 和桌面应用双界面选项，完美适配本地、SSH 远程环境和 WSL 环境。这个终极指南将带你从零开始，掌握从本地部署到云端配置的完整流程，大幅提升你的开发效率。🚀

📋 环境准备与快速安装

在开始部署前，确保你的系统满足以下要求：

系统要求

• Python 3.8+ 环境
• 支持的操作系统：Windows、macOS、Linux
• 网络连接（用于下载依赖包）

一键安装步骤

使用 uv 工具快速安装最新版本：

pip install uv uvx mcp-feedback-enhanced@latest version

MCP 配置方法

创建或编辑你的 MCP 配置文件，添加以下基础配置：

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

Web UI 主界面 - 支持 Markdown 渲染和智能工作流

🖥️ 桌面应用部署指南

v2.5.0 版本引入了基于 Tauri 框架的跨平台桌面应用支持，提供原生的桌面体验。

桌面应用启用方法

在 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"] } } }

本地构建桌面应用

如果你需要从源码构建桌面应用，需要安装以下工具链：

# 安装 Rust 工具链 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # 安装 Tauri CLI cargo install tauri-cli # 构建桌面应用 make build-desktop

构建完成后，可执行文件位于src/mcp_feedback_enhanced/desktop_release/目录，包含：

• Windows:mcp-feedback-enhanced-desktop.exe
• macOS Intel:mcp-feedback-enhanced-desktop-macos-intel
• macOS Apple Silicon:mcp-feedback-enhanced-desktop-macos-arm64
• Linux:mcp-feedback-enhanced-desktop-linux

桌面应用界面 - 原生跨平台体验，功能与 Web UI 完全一致

🌐 远程环境部署方案

SSH 远程开发环境配置

在 SSH 远程环境中，需要调整配置以允许远程访问：

解决方案 1：环境变量设置（推荐）

{ "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://[远程主机IP]:8765

解决方案 2：SSH 端口转发

1. 使用默认配置（MCP_WEB_HOST:127.0.0.1）
2. 设置 SSH 端口转发：
   • VS Code Remote SSH：按Ctrl+Shift+P→ "Forward a Port" → 输入8765
   • Cursor SSH Remote：手动添加端口转发规则（端口 8765）
3. 在本地浏览器访问：http://localhost:8765

SSH远程连接界面 - 支持内网穿透和远程访问

WSL 环境配置

Windows Subsystem for Linux 环境下的配置与本地环境类似，但需要注意：

1. 确保 WSL 2 已启用并更新到最新版本
2. 配置正确的网络设置
3. 使用MCP_WEB_HOST=0.0.0.0允许从 Windows 主机访问

⚙️ 高级配置与优化

环境变量详解

系统支持以下环境变量进行精细控制：

多语言支持配置

系统支持三种语言界面，优先级如下：

1. 界面中用户保存的语言设置（最高优先级）
2. MCP_LANGUAGE环境变量
3. 系统环境变量（LANG、LC_ALL 等）
4. 系统默认语言
5. 回退到默认语言（繁体中文）

缓存管理策略

由于频繁使用uvx命令，缓存可能会积累到数十 GB。建议定期清理：

# 查看缓存大小 python scripts/cleanup_cache.py --size # 预览清理内容 python scripts/cleanup_cache.py --dry-run # 执行清理 python scripts/cleanup_cache.py --clean # 强制清理（尝试关闭相关进程） python scripts/cleanup_cache.py --force

详细缓存管理指南可参考：docs/en/cache-management.md

🔧 故障排除与优化

常见问题解决方案

问题：浏览器无法启动或访问

• 解决方案：设置MCP_WEB_HOST为0.0.0.0允许远程访问
• 详细指南：SSH Remote 环境使用指南

问题：未收到新的 MCP 反馈

• 解决方案：直接刷新浏览器页面，通常是 WebSocket 连接问题

问题：MCP 未被调用

• 解决方案：确认 MCP 工具状态显示绿灯，反复切换 MCP 工具开关，等待几秒让系统重新连接

问题：图像上传失败

• 检查文件格式（PNG/JPG/JPEG/GIF/BMP/WebP）
• 系统支持任意大小的图像文件

系统设置界面 - 支持界面布局、语言、图片处理策略等全面配置

性能优化建议

1. 内存管理：定期清理会话历史，避免内存占用过高
2. 网络优化：在远程环境中使用更稳定的网络连接
3. 缓存清理：定期清理 UV 缓存，释放磁盘空间
4. 会话超时设置：根据使用场景调整会话超时时间

🚀 生产环境部署最佳实践

安全配置

• 在生产环境中使用127.0.0.1而不是0.0.0.0
• 配置防火墙规则，限制访问来源
• 定期更新到最新版本，获取安全修复

监控与日志

• 启用MCP_DEBUG=true进行问题排查
• 监控 WebSocket 连接状态
• 定期检查系统资源使用情况

备份策略

• 定期备份会话数据
• 导出重要会话记录为 JSON、CSV 或 Markdown 格式
• 备份配置文件和环境变量设置

📊 版本升级与维护

检查当前版本

uvx mcp-feedback-enhanced@latest version

升级到最新版本

uvx mcp-feedback-enhanced@latest

版本回滚

如果需要回滚到特定版本：

uvx mcp-feedback-enhanced@2.5.0

开发环境更新

对于开发者，建议使用本地安装：

git clone https://gitcode.com/gh_mirrors/mc/mcp-feedback-enhanced.git cd mcp-feedback-enhanced uv sync

🎯 总结与建议

MCP Feedback Enhanced 作为一个强大的交互式反馈系统，通过双界面架构和灵活的部署选项，为开发者提供了无缝的反馈工作流。无论是本地开发、远程 SSH 环境还是 WSL 环境，都能获得一致的用户体验。

关键要点：

1. 选择合适的部署模式：根据环境选择桌面应用或 Web UI
2. 正确配置网络设置：特别是远程环境下的主机绑定
3. 定期维护：清理缓存、更新版本、备份数据
4. 利用高级功能：自动提交、会话管理、多语言支持等

通过本指南的详细步骤，你应该能够成功部署和配置 MCP Feedback Enhanced，享受高效的 AI 辅助开发体验。如果在部署过程中遇到任何问题，请参考项目文档或提交问题报告。

官方文档：docs/architecture/桌面构建指南：docs/DESKTOP_BUILD.md工作流文档：docs/WORKFLOWS.md

【免费下载链接】mcp-feedback-enhancedInteractive User Feedback MCP项目地址: https://gitcode.com/gh_mirrors/mc/mcp-feedback-enhanced