mcp-feedback-enhanced 故障排除手册：10个常见问题及解决方案

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

mcp-feedback-enhanced 是一款强大的交互式用户反馈工具，但在使用过程中可能会遇到各种问题。本手册整理了10个最常见的问题及其解决方案，帮助您快速解决使用困扰，提升工作效率。

1. SSH Remote 环境下浏览器无法启动或访问

在 SSH Remote 环境（如 Cursor SSH Remote、VS Code Remote SSH）中使用时，常遇到浏览器无法自动启动或 Web UI 无法访问的问题。

解决方案

方案一：环境变量设置（v2.5.5 推荐）

在 MCP 配置中设置 "MCP_WEB_HOST": "0.0.0.0" 允许远程访问：

{
  "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

方案二：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 Remote 环境中设置端口转发的界面

详细解决方案请参考：SSH Remote 环境使用指南

2. 未接收到 MCP 新的反馈

使用过程中可能会遇到 MCP 新反馈未及时显示的问题。

解决方案

这通常是 WebSocket 连接问题导致的。解决方法：直接重新刷新浏览器页面，这会重新建立 WebSocket 连接。

3. 无法调用出 MCP

MCP 工具没有被正确调用，无法启动反馈界面。

解决方案

请确认 MCP 工具状态为绿灯（表示正常运作）。解决方法：

• 检查 IDE 中的 MCP 工具状态指示灯
• 如果不是绿灯，尝试反复开关 MCP 工具
• 等待几秒钟让系统重新连接

4. Augment 无法启动 MCP

有时可能会有错误导致 MCP 工具没有显示绿灯状态。

解决方案

解决方法：

• 完全关闭并重新启动 VS Code 或 Cursor
• 重新打开项目
• 等待 MCP 工具重新加载并显示绿灯

5. UV Cache 占用过多磁盘空间

由于频繁使用 uvx 命令，cache 可能会累积到数十 GB，占用大量磁盘空间。

解决方案

建议定期清理：

# 查看 cache 大小和详细信息
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

详细说明请参考：Cache 管理指南

6. 清理 cache 时出现「文件正由另一个程序使用」错误

清理 cache 过程中遇到文件被占用的错误提示。

解决方案

原因：有 MCP 服务器或其他 uvx 程序正在运行

解决方法：

1. 关闭相关程序：

   • 关闭 Claude Desktop 或其他使用 MCP 的应用
   • 结束所有 uvx 相关程序

2. 使用强制清理：

   python scripts/cleanup_cache.py --force
   

3. 手动清理：

   # Windows
   taskkill /f /im uvx.exe
   taskkill /f /im python.exe /fi "WINDOWTITLE eq *mcp-feedback-enhanced*"
   
   # 然后执行清理
   uv cache clean
   

7. 桌面应用程序构建失败

尝试构建桌面应用程序时遇到错误。

解决方案

常见原因及解决方法：

1. Rust 未安装

   ❌ Rust 未安装，請訪問 https://rustup.rs/
   

   解决方案: 安装 Rust 工具链

2. Tauri CLI 未安装

   ⚠️ Tauri CLI 未安裝，正在安裝...
   

   解决方案: 脚本会自动安装，或手动执行 cargo install tauri-cli

3. 构建失败

   ❌ 构建失败
   

   解决方案: 检查 Rust 环境，清理后重新构建

   make clean-desktop
   make build-desktop
   

详细构建指南请参考：桌面应用程式構建指南

8. "Unexpected token 'D'" 错误

在使用过程中遇到意外的令牌错误。

解决方案

这通常是调试输出干扰导致的。设置 MCP_DEBUG=false 或移除该环境变量即可解决。

9. 图片上传失败

尝试上传图片时遇到错误或无响应。

解决方案

检查文件格式是否支持（PNG/JPG/JPEG/GIF/BMP/WebP）。系统支持任意大小的图片文件。如果问题仍然存在，可以尝试刷新页面或重启 MCP 服务。

图：mcp-feedback-enhanced 的 Web UI 界面，显示图片上传区域

10. AI 模型无法解析图片

各种 AI 模型（包括 Gemini Pro 2.5、Claude 等）在图片解析上可能存在不稳定性。

解决方案

这是 AI 视觉理解技术的已知限制。建议：

1. 确保图片质量良好（高对比度、清晰文字）
2. 多尝试几次上传，通常重试可以成功
3. 如持续无法解析，可尝试调整图片大小或格式

总结

以上是使用 mcp-feedback-enhanced 时最常见的10个问题及其解决方案。如果您遇到其他未涵盖的问题，可以查阅官方文档或在项目的 Issues 页面寻求帮助。

通过正确配置和定期维护，mcp-feedback-enhanced 将成为您收集和管理用户反馈的强大工具，提升工作效率和用户满意度。

图：mcp-feedback-enhanced 桌面应用程序界面

---

希望本故障排除手册能帮助您顺利解决使用 mcp-feedback-enhanced 过程中遇到的问题。如需获取更多帮助，请查阅项目文档或提交 Issue 反馈。

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