How do I use user-web-feedback?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@user-web-feedback open the feedback panel" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

user-web-feedback

by HyperHeroX

Overview Schema Related Servers Score Discussions

TypeScript

🎯 MCP 使用者反饋收集器

npm version License: MIT Node.js Version

基於 Node.js 的現代化 MCP 反饋收集器，支援 AI 工作匯報和使用者反饋收集。

** 這是 Fork 自三少科技的專案 ** (https://github.com/sanshao85/mcp-feedback-collector-web) 感謝三少科技的無私奉獻

Related MCP server: Feedback Synthesis MCP

🆕 增強版反饋介面

全新的增強版使用者介面現已推出！

🌟 核心特性

🎨 三欄式佈局設計

左側（30%）：AI 工作匯報顯示區
- 支援 Markdown 渲染
- 程式碼語法高亮
- 可捲動查看歷史訊息
中間（40%）：使用者互動區
- 文字回應輸入（支援 Ctrl+Enter 快速提交）
- 圖片上傳/貼上功能
- AI 輔助回覆按鈕
- 即時連接狀態顯示（底部中央）
右側（30%）：提示詞管理區
- 提示詞 CRUD 操作
- 搜尋和過濾功能
- 釘選常用提示詞
- AI 設定管理

🤖 AI 輔助回覆（Gemini API）

整合 Google Gemini 2.5 Flash API
根據 AI 工作匯報自動生成建議回覆
可自訂系統提示詞
智能重試機制和錯誤處理
支援溫度參數和最大 token 數調整

📝 提示詞管理系統

CRUD 操作：創建、讀取、更新、刪除提示詞
釘選功能：釘選常用提示詞，啟動時自動載入
分類管理：支援提示詞分類（選填）
搜尋過濾：快速找到需要的提示詞
順序調整：拖拽調整提示詞顯示順序
點擊插入：點擊提示詞快速插入到輸入區

⏰ 自動回覆機制

5 分鐘無活動：自動觸發 AI 回覆
60 秒倒數警告：提前通知使用者
可取消：使用者可隨時取消自動回覆
可調整超時：通過使用者偏好設定調整超時時間

🔒 資料加密保護

AES-256-GCM 加密：保護 API Key 等敏感資料
SQLite 本地儲存：所有資料本地化儲存
密碼派生：使用 scrypt 從主密碼派生加密金鑰
遮罩顯示：前端僅顯示 API Key 的遮罩版本

🔌 MCP Server 整合

多 Server 支援：同時連接多個 MCP Server
三種傳輸方式：stdio、SSE、Streamable HTTP
AI 工具呼叫：AI 自動識別並呼叫 MCP 工具
多輪執行：最多 5 輪自動工具呼叫
進度指示：即時顯示工具執行狀態

🎯 使用者體驗優化

響應式設計：支援各種螢幕尺寸
快捷鍵支援：Ctrl+Enter 提交、Ctrl+V 貼上圖片
即時連接狀態：WebSocket 連接狀態實時顯示（底部中央對齊）
錯誤提示：友善的錯誤訊息和操作指引
自動儲存：使用者偏好和設定自動保存

📖 詳細文檔

完整的使用說明請參閱：增強版反饋介面指南

🚀 訪問增強版介面

http://localhost:3000/index.html

✨ 標準版特性

🚀 一鍵啟動：使用 npx @hirohsu/user-web-feedback 直接運行
🎨 現代界面：VS Code 深色主題風格的 Web 界面
🔧 MCP 整合：完整支援 Model Context Protocol
💬 AI 對話功能：整合 AI 助手，支援文字和圖片對話
🖼️ 圖片支援：完整的圖片上傳、處理和顯示功能
📄 圖片轉文字：AI 智能圖片描述，提升客戶端兼容性
🌐 跨平台：支援 Windows、macOS、Linux
⚡ 高效能：解決了 Python 版本的穩定性問題

📚 教學資源

開發過程視頻教程

YouTube：https://youtu.be/Osr1OSMgzlg
Bilibili：https://www.bilibili.com/video/BV1PHTxzSErb/

🚀 快速開始

安裝和運行

# 直接運行（推薦）
npx @hirohsu/user-web-feedback

# 或者全局安裝
npm install -g @hirohsu/user-web-feedback
user-web-feedback

# 檢查版本
user-web-feedback --version

📦 NPM 發行版本使用指南

從 npm 安裝

# 全局安裝（推薦）
npm install -g @hirohsu/user-web-feedback

# 專案內安裝
npm install @hirohsu/user-web-feedback

使用 npx 運行（無需安裝）

# 運行最新版本
npx @hirohsu/user-web-feedback

# 指定版本
npx @hirohsu/user-web-feedback@2.2.0

# 帶參數運行
npx @hirohsu/user-web-feedback --port 8080

程式化使用

// ESM 模組
import { MCPServer, getConfig } from '@hirohsu/user-web-feedback';

const config = getConfig();
const server = new MCPServer(config);
await server.start();

發行版本特性

✅ 獨立運行：編譯後的 dist/ 目錄可獨立執行，無需原始碼
✅ 安全發行：不包含敏感資訊、開發檔案或原始碼
✅ 版本一致：CLI、API、Web 介面版本號自動同步
✅ 跨平台：支援 Windows、macOS、Linux

環境變數配置

創建 .env 文件：

# AI API 配置
MCP_API_KEY="your_api_key_here"
MCP_API_BASE_URL="https://api.ssopen.top"  # 中轉站，也可使用 OpenAI 官方 API
MCP_DEFAULT_MODEL="grok-3"

# Web 服務器配置
MCP_WEB_PORT="5000"
MCP_DIALOG_TIMEOUT="60000"  # 反饋收集超時時間（秒），範圍：10-60000

# 功能開關
MCP_ENABLE_CHAT="true"
MCP_ENABLE_IMAGE_TO_TEXT="true"  # 啟用圖片轉文字功能

# 增強版介面專用配置
MCP_ENCRYPTION_PASSWORD="your-secure-password"  # API Key 加密主密碼（強烈建議設定）

# URL 和端口優化配置 (v2.0.7 新增)
MCP_USE_FIXED_URL="true"           # 使用固定 URL，不帶會話參數 (預設: true)
MCP_CLEANUP_PORT_ON_START="true"   # 啟動時清理端口 (預設: true)

# 多實例支援 (v2.3.0 新增)
# 當端口被佔用時，系統會自動遞增到下一個可用端口
# 例如：5050 被佔用 → 自動使用 5051
# 最多嘗試 20 個連續端口

🔧 使用方法

命令行選項

# 啟動服務器（預設）
npx @hirohsu/user-web-feedback

# 指定端口
npx @hirohsu/user-web-feedback --port 8080

# 僅 Web 模式
npx @hirohsu/user-web-feedback --web

# 測試 collect_feedback 功能
npx @hirohsu/user-web-feedback test-feedback

# 自訂測試內容
npx @hirohsu/user-web-feedback test-feedback -m "我的工作匯報" -t 120

# 健康檢查
npx @hirohsu/user-web-feedback health

# 顯示配置
npx @hirohsu/user-web-feedback config

🔌 Claude Desktop / Cursor 整合

方式一：NPM 套件運行（推薦）

在 Claude Desktop 或 Cursor 的 MCP 配置中添加：

{
  "mcpServers": {
    "user-web-feedback": {
      "command": "npx",
      "args": ["-y", "@hirohsu/user-web-feedback@latest"],
      "env": {
        "MCP_API_KEY": "your_api_key_here",
        "MCP_API_BASE_URL": "https://api.ssopen.top",
        "MCP_DEFAULT_MODEL": "grok-3",
        "MCP_WEB_PORT": "5050",
        "MCP_DIALOG_TIMEOUT": "60000",
        "MCP_ENABLE_IMAGE_TO_TEXT": "true",
        "MCP_ENCRYPTION_PASSWORD": "your-secure-password"
      }
    }
  }
}

當使用自訂 register 時，請設定:

{
  "mcpServers": {
    "user-web-feedback": {
      "command": "npx",
      "args": ["-y", "@hirohsu/user-web-feedback@latest", "--register", "http://localhost:5050"],
      "env": {
        "MCP_API_KEY": "your_api_key_here",
        "MCP_API_BASE_URL": "https://api.ssopen.top",
        "MCP_DEFAULT_MODEL": "grok-3",
        "MCP_WEB_PORT": "5050",
        "MCP_DIALOG_TIMEOUT": "60000",
        "MCP_ENABLE_IMAGE_TO_TEXT": "true",
        "MCP_ENCRYPTION_PASSWORD": "your-secure-password"
      }
    }
  }
}

方式二：原始碼運行（本地開發）

如果您複製了原始碼並想直接運行：

{
  "mcpServers": {
    "user-web-feedback": {
      "command": "node",
      "args": ["path/to/your/project/dist/cli.js"],
      "env": {
        "MCP_API_KEY": "your_api_key_here",
        "MCP_API_BASE_URL": "https://api.ssopen.top",
        "MCP_DEFAULT_MODEL": "grok-3",
        "MCP_WEB_PORT": "5050",
        "MCP_DIALOG_TIMEOUT": "60000",
        "MCP_ENCRYPTION_PASSWORD": "your-secure-password"
      }
    }
  }
}

注意：

將 path/to/your/project 替換為您的實際專案路徑
確保已運行 npm run build 構建專案
使用絕對路徑，例如：d:/zhuomian/nodejsweb/dist/cli.js

方式三：TypeScript 原始碼直接運行（開發模式）

直接運行 TypeScript 原始碼而無需構建：

{
  "mcpServers": {
    "user-web-feedback": {
      "command": "npx",
      "args": ["tsx", "path/to/your/project/src/cli.ts"],
      "env": {
        "MCP_API_KEY": "your_api_key_here",
        "MCP_API_BASE_URL": "https://api.ssopen.top",
        "MCP_DEFAULT_MODEL": "grok-3",
        "MCP_WEB_PORT": "5050",
        "MCP_DIALOG_TIMEOUT": "60000",
        "NODE_ENV": "development"
      }
    }
  }
}

優點：無需構建，直接運行原始碼
缺點：啟動稍慢，需要 tsx 依賴

🚀 快速配置範例

假設您的專案位於 d:\zhuomian\nodejsweb，推薦配置：

{
  "mcpServers": {
    "user-web-feedback": {
      "command": "node",
      "args": ["d:/zhuomian/nodejsweb/dist/cli.js"],
      "env": {
        "MCP_API_KEY": "your_api_key_here",
        "MCP_API_BASE_URL": "https://api.ssopen.top",
        "MCP_DEFAULT_MODEL": "grok-3",
        "MCP_WEB_PORT": "5050",
        "MCP_DIALOG_TIMEOUT": "60000"
      }
    }
  }
}

配置步驟：

確保專案已構建：npm run build
將上述配置添加到 Cursor 的 MCP 設定中
替換 your_api_key_here 為您的實際 API 密鑰
重啟 Cursor，查看 MCP 服務器狀態為綠色

在 Cursor 規則中配置

在 Cursor 的規則中可以這樣配置：

Whenever you want to ask a question, always call the MCP.

Whenever you're about to complete a user request, call the MCP instead of simply ending the process. Keep calling MCP until the user's feedback is empty, then end the request. user-web-feedback.collect_feedback

⚠️ 重要提醒

不要在 args 中添加 --debug 參數，這會導致 JSON 解析失敗
Cursor/Claude Desktop 要求極其純淨的 JSON 輸出
如需除錯，請在命令行中單獨使用：npx @hirohsu/user-web-feedback --debug

💡 API 服務推薦

預設配置使用 https://api.ssopen.top 中轉站，支援多種 AI 模型
也可以使用 OpenAI 官方 API：https://api.openai.com/v1
或其他相容 OpenAI 格式的 API 服務

🌐 HTTP 傳輸模式（Docker 部署）

除了傳統的 stdio 傳輸模式，本系統現在支援 HTTP 傳輸模式（SSE 和 Streamable HTTP），使其能夠在 Docker 容器中運行並接受遠端 MCP 連線。

傳輸模式說明

模式	描述	適用場景
`stdio`	標準輸入/輸出傳輸（預設）	本地 MCP 客戶端（Claude Desktop、Cursor）
`sse`	Server-Sent Events	Docker 部署、遠端連線
`streamable-http`	Streamable HTTP	Docker 部署、現代 HTTP 串流

使用方式

命令列啟動

# 使用 SSE 傳輸模式
npx @hirohsu/user-web-feedback --transport sse

# 使用 Streamable HTTP 傳輸模式
npx @hirohsu/user-web-feedback --transport streamable-http

環境變數配置

# 設定傳輸模式
MCP_TRANSPORT=sse  # 或 streamable-http

Docker 部署

使用 Docker Compose（推薦）

# 啟動服務
docker-compose up -d

# 查看日誌
docker-compose logs -f

使用 Docker 直接運行

# 構建映像
docker build -t user-feedback-web .

# 運行容器
docker run -d \
  --name user-feedback-web \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_WEB_PORT=3000 \
  -v ./data:/app/data \
  user-feedback-web

HTTP MCP Server 配置範例

Claude Desktop / Cursor 配置（連接到 Docker 容器）

使用 SSE 傳輸連接到運行中的 Docker 容器：

{
  "mcpServers": {
    "user-web-feedback": {
      "transport": "sse",
      "url": "http://localhost:3000/mcp/sse"
    }
  }
}

使用 Streamable HTTP 傳輸：

{
  "mcpServers": {
    "user-web-feedback": {
      "transport": "streamable-http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

遠端伺服器連接

如果 Docker 容器運行在遠端伺服器：

{
  "mcpServers": {
    "user-web-feedback": {
      "transport": "sse",
      "url": "http://your-server-ip:3000/mcp/sse"
    }
  }
}

HTTP 端點說明

端點	方法	描述
`/mcp/sse`	GET	SSE 連線端點
`/mcp/message`	POST	SSE 訊息端點
`/mcp`	POST	Streamable HTTP 端點
`/health`	GET	健康檢查端點

注意事項

安全性：HTTP 傳輸模式不包含內建認證，建議在生產環境中使用反向代理（如 nginx）添加 HTTPS 和認證。
網路配置：確保防火牆允許對應端口的流量。
日誌：可透過 LOG_LEVEL 環境變數調整日誌級別（debug、info、warn、error）。

🆕 最新功能 (v2.1.3+)

🎨 增強版反饋介面（最新）

完整的介面重構，提供專業級使用者體驗：

✅ 三欄式佈局：AI 訊息、使用者輸入、提示詞管理
✅ AI 輔助回覆：整合 Gemini API，自動生成建議回覆
✅ 提示詞管理：CRUD 操作、釘選、搜尋、分類
✅ 自動回覆機制：5 分鐘無活動自動觸發 AI 回覆
✅ 資料持久化：SQLite 本地儲存
✅ API Key 加密：AES-256-GCM 加密保護
✅ 響應式設計：支援各種螢幕尺寸
✅ 即時連接狀態：WebSocket 狀態顯示（底部中央）

詳細說明：增強版反饋介面指南

📋 MCP 標準日誌功能

完整日誌支援：實現 MCP 協定標準的日誌功能，完全符合 MCP 規範
多級別日誌：支援 debug、info、notice、warning、error、critical、alert、emergency 八個標準級別
客戶端控制：支援 MCP 客戶端通過 logging/setLevel 請求動態設定日誌級別
即時通知：所有日誌自動通過 notifications/message 發送到 MCP 客戶端
專業輸出：移除表情符號，提供乾淨專業的日誌輸出，適合生產環境
非同步處理：優化日誌通知的非同步處理，避免未處理的 Promise 拒絕錯誤
智能過濾：根據設定的日誌級別智能過濾輸出內容

🔧 重大改進：智能端口衝突解決方案

智能端口管理：自動檢測和解決端口衝突，無需手動介入
漸進式進程終止：優雅終止 → 強制終止 → 多種備用方案
自進程識別：能準確識別和清理自己的僵尸進程
跨平台相容：Windows/macOS/Linux 統一處理機制
智能降級：無法清理時自動尋找替代端口

🛡️ 優雅退出處理

完整信號處理：支援 SIGINT、SIGTERM、SIGBREAK（Windows）
智能異常處理：優化未捕獲異常和 Promise 拒絕的處理機制
防重複關閉：添加關閉狀態標誌，避免重複執行關閉流程
客戶端通知：關閉前通知所有連接的客戶端
資源清理：確保所有資源正確釋放，避免僵尸進程

🚀 使用者體驗提升

詳細日誌：清晰的進程終止和端口釋放日誌，支援 MCP 標準日誌輸出
自動處理：大部分端口衝突自動解決，智能降級策略
智能提示：明確的狀態提示和錯誤訊息，專業化輸出格式
無縫體驗：使用者無需關心底層端口管理和日誌配置
開發友善：完整的 MCP 協定支援，便於整合和除錯

📄 圖片轉文字功能 (v2.1.1)

智能圖片描述：AI 自動將圖片轉換為詳細文字描述
相容性提升：解決部分 MCP 客戶端無法顯示圖片的問題
使用者可控：點擊「圖片轉文本」按鈕主動轉換
可編輯描述：使用者可以修改 AI 生成的圖片描述
批次處理：支援多張圖片同時轉換

🎨 UI 簡化優化 (v2.1.1)

純文字狀態顯示：移除旋轉動畫，簡潔直觀
智能自動刷新：預設啟用，無需使用者選擇
簡約設計：符合現代 UI 設計趨勢

🔄 會話管理優化 (v2.1.1)

智能頁面刷新：檢測新內容時自動刷新頁面
會話自動重置：解決「對話過期」問題
無縫體驗：3 秒倒數提示

🔗 固定 URL 模式 (v2.0.7)

使用固定根路徑：http://localhost:5000
支援多個並發會話
便於遠端服務器轉發

🛠️ MCP 工具函數

collect_feedback

收集使用者對 AI 工作的反饋：

// 基本呼叫（超時時間從環境變數讀取）
collect_feedback("我已經完成了程式碼重構工作，主要改進了效能和可讀性。")

參數說明：

work_summary（必需）：AI 工作匯報內容

超時時間配置：

超時時間通過環境變數 MCP_DIALOG_TIMEOUT 統一配置
預設值為 60000 秒（約 16.7 小時）
有效範圍：10-60000 秒

功能：

啟動 Web 界面顯示工作匯報
收集使用者文字和圖片反饋
返回結構化的反饋資料
自動管理服務器生命週期
提交反饋後自動關閉標籤頁（3 秒倒數）

📋 MCP 日誌功能

本專案完全支援 MCP 協定標準的日誌功能，提供專業級的日誌管理：

服務器能力聲明：

在 MCP 初始化時自動聲明 logging 能力
完全符合 MCP 協定規範，支援所有標準日誌級別
提供動態日誌級別控制和即時通知功能

支援的日誌級別（按優先級排序）：

emergency - 緊急情況，系統不可用
alert - 警報資訊，需要立即處理
critical - 關鍵錯誤，嚴重問題
error - 錯誤資訊，功能異常
warning - 警告資訊，潛在問題
notice - 通知資訊，重要事件
info - 一般資訊，常規操作
debug - 除錯資訊，詳細追蹤

客戶端控制：

{
  "method": "logging/setLevel",
  "params": {
    "level": "info"
  }
}

日誌通知格式：

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "logger": "user-web-feedback",
    "data": {
      "message": "服務器啟動成功",
      "port": 5000,
      "url": "http://localhost:5000"
    }
  }
}

技術特性：

非同步處理：優化的非同步日誌處理，避免阻塞主執行緒
錯誤恢復：完善的錯誤處理機制，避免日誌系統影響主功能
智能過濾：根據設定的級別自動過濾日誌輸出
結構化資料：支援複雜物件的日誌記錄，便於除錯分析

這使得 Claude Desktop、Cursor 等 MCP 客戶端能夠接收和處理服務器的日誌資訊，大大提升了開發和除錯體驗。

🎨 界面特性

增強版介面

三欄式佈局：AI 訊息 + 使用者輸入 + 提示詞管理
Markdown 渲染：完整支援 Markdown 語法和程式碼高亮
響應式設計：支援各種螢幕尺寸
即時連接狀態：WebSocket 連接狀態即時顯示（底部中央對齊）
多模態支援：文字 + 圖片組合輸入
智能提示：友善的錯誤訊息和操作指引

標準版介面

雙標籤頁設計：工作匯報 + AI 對話
VS Code 主題：深色主題，專業美觀
響應式佈局：支援桌面和行動裝置
即時通信：WebSocket 連接狀態指示
多模態支援：文字 + 圖片組合輸入
智能提交確認：使用者可選擇提交後是否關閉頁面
靈活操作：支援取消提交和多種互動方式

📋 系統要求

Node.js：18.0.0 或更高版本
瀏覽器：Chrome 90+、Firefox 88+、Safari 14+、Edge 90+
作業系統：Windows 10+、macOS 10.15+、Ubuntu 18.04+

🔒 安全特性

增強版介面專用

AES-256-GCM 加密：保護 API Key 等敏感資料
密碼派生：使用 scrypt 從主密碼派生加密金鑰
本地儲存：SQLite 本地資料庫，不上傳至雲端
遮罩顯示：前端僅顯示 API Key 的部分字元

通用安全

輸入驗證和檔案大小限制
CORS 配置和安全標頭
API 密鑰安全儲存
惡意內容基礎檢測

📊 效能指標

啟動時間：< 3 秒
記憶體使用：< 100MB
回應時間：< 2 秒
並發連接：支援 10 個同時連接

🐛 故障排除

增強版介面相關

問題：API Key 驗證失敗

解決方法：

檢查 API Key 是否正確
確認模型名稱是否有效（例如：gemini-2.0-flash-exp）
檢查網路連接
查看瀏覽器控制台的錯誤訊息
確認 API URL 是否正確（預設：https://generativelanguage.googleapis.com/v1beta）

問題：資料庫初始化失敗

解決方法：

檢查 data 目錄的寫入權限
確認沒有其他程序正在使用資料庫檔案
刪除損壞的資料庫檔案（data/feedback.db）並重新啟動

問題：自動回覆未觸發

解決方法：

檢查使用者偏好設定中是否啟用自動回覆
確認 AI 設定已正確配置（API Key、模型名稱）
查看服務器日誌的錯誤訊息
確認網路連接正常

問題：提示詞無法儲存

解決方法：

檢查資料庫連接狀態
嘗試刷新頁面
查看瀏覽器控制台的錯誤訊息
確認 data 目錄有寫入權限

標準版介面相關

1. WebSocket 連接失敗

# 檢查服務器狀態
npx @hirohsu/user-web-feedback health

# 訪問測試頁面
http://localhost:5000/test.html

# 查看瀏覽器控制台錯誤訊息

2. 端口被占用

# 檢查端口使用情況
netstat -an | grep :5000

# 使用其他端口
npx @hirohsu/user-web-feedback --port 5001

3. API 密鑰錯誤

# 檢查配置
npx @hirohsu/user-web-feedback config

# 設定環境變數
export MCP_API_KEY="your_key_here"

4. 權限問題

# 使用 npx 避免全域安裝權限問題
npx @hirohsu/user-web-feedback

詳細的故障排除指南請參考：TROUBLESHOOTING.md

📚 完整文檔

本專案提供了完整的文檔體系，請參考 📚 文檔索引查找您需要的資訊：

使用者指南：USER_GUIDE.md - 詳細使用說明
增強版指南：ENHANCED_FEEDBACK_GUIDE.md - 增強版介面專用指南
配置指南：CONFIGURATION.md - 環境變數配置
技術文檔：ARCHITECTURE.md - 系統架構設計
故障排除：TROUBLESHOOTING.md - 問題解決方案
版本說明：RELEASE_NOTES.md - 版本更新記錄
開發文檔：DEVELOPMENT.md - 開發環境搭建和貢獻指南
技術文檔：TECHNICAL.md - 系統架構和技術細節
更新日誌：CHANGELOG.md - 版本變更歷史

📝 開發

本地開發

# 複製專案
git clone https://github.com/sanshao85/user-web-feedback-web.git
cd user-web-feedback-web

# 安裝依賴
npm install

# 開發模式（即時編譯 TypeScript）
npm run dev

# 構建專案（生成 dist 目錄）
npm run build

# 啟動已構建的專案
npm start

# 測試
npm test

# 健康檢查
npm start health

# 顯示配置
npm start config

MCP 配置測試

構建完成後，您可以使用以下配置在 Cursor 中測試：

{
  "mcpServers": {
    "user-web-feedback": {
      "command": "node",
      "args": ["您的專案路徑/dist/cli.js"],
      "env": {
        "MCP_API_KEY": "your_api_key_here",
        "MCP_API_BASE_URL": "https://api.ssopen.top",
        "MCP_DEFAULT_MODEL": "grok-3",
        "MCP_WEB_PORT": "5050",
        "MCP_DIALOG_TIMEOUT": "180",
        "MCP_ENCRYPTION_PASSWORD": "your-secure-password"
      }
    }
  }
}

專案結構

src/
├── cli.ts                    # CLI 入口
├── index.ts                  # 主入口
├── config/                   # 配置管理
├── server/                   # 服務器實現
│   ├── mcp-server.ts        # MCP 服務器
│   └── web-server.ts        # Web 服務器（增強版 API）
├── utils/                    # 工具函數
│   ├── crypto-helper.ts     # 加密工具（增強版）
│   ├── database.ts          # 資料庫工具（增強版）
│   └── ai-service.ts        # AI 服務（增強版）
├── types/                    # 類型定義
│   └── index.ts             # TypeScript 介面
└── static/                   # 靜態檔案
    ├── index.html           # 增強版介面（主入口）
    ├── style.css            # 增強版樣式
    ├── app.js               # 增強版邏輯
    ├── index-enhanced.html  # 舊版檔案（備用）
    ├── style-enhanced.css   # 舊版樣式（備用）
    └── app-enhanced.js      # 舊版邏輯（備用）

📊 專案狀態

當前版本：v2.1.3+（增強版介面）
維護狀態：積極維護
支援平台：Windows、macOS、Linux
最新特性：增強版反饋介面（三欄式佈局、AI 輔助、提示詞管理、自動回覆、資料加密）
協定支援：MCP v2025-03-26、v2024-11-05、v2024-10-07
SDK 版本：@modelcontextprotocol/sdk v1.12.1

📄 授權

MIT License - 詳見 LICENSE 檔案

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

Fork 本儲存庫
創建您的特性分支（git checkout -b feature/AmazingFeature）
提交您的更改（git commit -m 'Add some AmazingFeature'）
推送到分支（git push origin feature/AmazingFeature）
打開一個 Pull Request

🔗 相關連結

原始專案主頁：GitHub Repository
NPM 套件：@hirohsu/user-web-feedback
Model Context Protocol：官方網站
MCP 規範：技術規範
Claude Desktop：下載地址

💝 感謝支持

特別感謝 https://api.ssopen.top/ API 中轉站，提供 290+ AI 大模型，官方成本七分之一，支援高並發！

🚀 快速導航

🆕 增強版介面指南 - 最新功能
📖 使用者指南 - 標準版使用說明
🔧 配置指南 - 環境變數設定
🐛 故障排除 - 常見問題解答
🏗️ 技術架構 - 系統設計文檔
📝 更新日誌 - 版本變更歷史

立即體驗增強版介面：http://localhost:3000/index.html 🎉

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

collect_feedbackA

Related MCP Servers

MCP Feedback Enhanced
App Automation Customer Support
find-xposed-magisk
F
license
B
quality
D
maintenance
Enables interactive feedback collection through a web interface with support for image uploads, extended timeout handling, and offline reconnection capabilities for long-running AI conversations.
Updated 7 months ago (2026-01-08 18:42 UTC)
2
Feedback Synthesis MCP
Customer Support Product Management Research & Data
sapph1re
A
license
A
quality
C
maintenance
MCP server that synthesizes user feedback from multiple sources into actionable insights. Aggregates reviews, support tickets, and survey responses to identify patterns and priorities.
Updated 2 months ago (2026-06-15 21:26 UTC)
4
MIT
ai-intervention-agent
Autonomous Agents Developer Tools
fastmcp-me
A
license
-
quality
D
maintenance
Enables real-time user intervention for MCP agents via a Web UI and interactive_feedback tool, allowing users to review context and send instructions when agents drift from intent.
Updated 6 months ago (2026-02-05 21:08 UTC)
MIT
mcp-feedback-pipe
Developer Tools Customer Support
ElemTran
A
license
-
quality
D
maintenance
Web-based feedback collection tool for MCP environments with Markdown, Mermaid charts, and image upload support.
Updated a year ago (2025-06-13 08:48 UTC)
2
MIT

View all related MCP servers

Related MCP Connectors

futureagievals-mcp
A paid remote MCP for AI SDK eval dashboard, built to return verdicts, receipts, usage logs, and aud
autobrowserapproval-mcp
A paid remote MCP for AI agent browser approval MCP, built to return verdicts, receipts, usage logs,
evalscopebench-mcp
A paid remote MCP for AI SDK benchmark dashboard, built to return verdicts, receipts, usage logs, an

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/HyperHeroX/user-feedback-web'

If you have feedback or need assistance with the MCP directory API, please join our Discord server