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. 改善體驗: 更流暢的人機協作開發流程