Minidoracat/mcp-feedback-enhanced

Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual interface support (Web UI and Desktop Application) with intelligent environment detection and cross-platform compatibility.

What is MCP Feedback Enhanced?

MCP Feedback Enhanced 는 서버 사이드 도구 로, Model Context Protocol (MCP) 생태계에 통합됩니다. 장시간 실행되는 AI 작업 중에 사람이 개입하는 피드백 UI 를 추가합니다. AI 모델(예: Cursor, Cline, Windsurf, Augment, Trae)이 확인이나 설명이 필요할 때, 모델은 mcp-feedback-enhanced 명령을 호출합니다. 이 도구는 웹 UI(또는 선택적 Tauri 기반 데스크톱 앱)를 시작하여 사용자가 요청을 검토하고 응답을 입력하거나, 이미지를 업로드하거나, 타이머를 통해 자동 제출할 수 있습니다. 응답은 WebSocket을 통해 AI로 전송되어 모델이 새로운 정보를 바탕으로 작업을 계속할 수 있게 합니다.

이 프로젝트는 Minidoracat 에 의해 유지되는 원본 interactive-feedback-mcp 구현의 포크입니다. 보안(위험한 명령 실행 제거, WebSocket 원본 검사 강화)에 중점을 두고 있으며, SSH 원격, WSL, 로컬 환경에서 UI가 신뢰성 있게 작동하도록 합니다.

Core ideas

Idea	Why it matters
Feedback‑oriented workflow	장시간 AI 기반 프로세스에서의 오차와 재작업을 줄이기 위해 명시적인 인간 체크포인트를 삽입합니다.
Dual interface	가벼운 브라우저 UI는 어디서나 작동; Tauri 데스크톱 래퍼는 Windows/macOS/Linux용 네이티브 스타일 앱을 제공(유지보수 전용, v3에서 제거 예정).
Environment awareness	SSH 원격 세션과 WSL를 자동 감지하여 추가 설정 없이 적절한 UI 모드를 선택합니다.
Session tracking	각 피드백 세션을 로컬에 저장(.JSON/CSV/Markdown), 실시간 통계를 표시하여 감사 또는 공유를 쉽게 합니다.
Security‑first updates	v2.6.1은 위험한 명령 실행 기능을 제거하고 WebSocket `Origin` 헤더를 검증하여 두 가지 고위험 취약점을 해결했습니다.

Who would use it?

개발자 : 코드 생성 어시스턴트, 데이터 레이블링 파이프라인 등 주기적으로 사용자 확인이 필요한 AI 보조 도구를 개발하는 사람.
팀 : Cursor, Cline 등 MCP 호환 클라이언트를 사용하며, 로컬, 원격, 컨테이너 환경에서 일관된 UI를 원하는 사람.
연구자 : 인터랙티브한 LLM 워크플로우를 프로토타이핑하며 인간 입력을 빠르게 기록하고 재생하고 싶은 사람.

Main features (as of v2.6.0)

Web UI – 기본적으로 http://127.0.0.1:8765 에서 실행, GUI 종속 없음, SSH 포트포워딩에서도 작동 가능.
Desktop app – 동일한 UI를 Tauri로 래핑(유지보수 전용, v3에서 제거 예정).
Prompt management – 재사용 가능한 프롬프트 생성, 편집, 삭제; 사용 통계 확인; 자동 정렬.
Auto‑timed submit – 설정 가능한 타이머(1 s – 86400 s)와 일시정지/재시작/취소 컨트롤.
Session history – 로컬 파일 저장, JSON/CSV/Markdown로 내보내기, 실시간 통계.
WebSocket connection monitoring – 상태 표시, 자동 재연결, 품질 지표.
Rich Markdown display – 제목, 코드 블록, 목록 등을 포함한 AI 요약 렌더링.
Audio & system notifications – 선택적 사운드 효과 및 OS 수준 알림(예: 자동 커밋, 타임아웃 시).
Internationalisation – 영어, 번체 중국어, 간체 중국어 지원; MCP_LANGUAGE로 언어 강제 지정 가능.
Image support – PNG/JPG/GIF/BMP/WebP를 드래그 앤 드롭 또는 클립보드 붙여넣기로 어떤 크기나 지원.

Getting started (quick‑run)

# uv 러너 설치 (없을 경우)
pip install uv

# 최신 버전 실행 (작성 시점은 v2.6.1)
uvx mcp-feedback-enhanced@latest

이 명령은 MCP 서버를 시작하고 웹 UI를 열며 URL(예: http://127.0.0.1:8765)을 출력합니다. 브라우저에서 해당 URL로 이동하거나, MCP 설정에서 "MCP_DESKTOP_MODE": "true"를 설정하여 네이티브 데스크톱 창을 엽니다.

Configuration snapshot

{
  "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.8 이후에도 데스크톱 앱을 유지하고 싶다면 uvx mcp-feedback-enhanced@latest를 핀된 버전(예: @2.8.0)으로 교체하세요.

Security & maintenance notes

v2.6.1은 인증되지 않은 WebSocket 클라이언트가 임의의 쉘 명령을 실행할 수 있던 오래된 "auto‑command" 기능을 제거했습니다. 서버는 이제 UI와 WebSocket만 제공하며, 명령 실행은 불가능합니다.
WebSocket origin validation은 다른 사이트가 연결을 가로채는 것을 방지합니다.
데스크톱 바이너리는 크기가 큽니다(~패키지의 80 %)이며, v3에서 비공식적으로 제거될 예정입니다. 장기적으로는 웹 UI가 권장되는 인터페이스입니다.
원래의 "쿼터 절약" 주장(여러 번의 왕복을 통합)은 2025년 6월 Cursor가 토큰 기반 요금제로 전환하면서 더 이상 유효하지 않습니다. 이 도구의 가치는 이제 사람의 체크포인트에 있으며, 비용 절감이 아닙니다.

Where to learn more

Full changelog – RELEASE_NOTES/CHANGELOG.en.md
Security details – SECURITY.md
SSH remote usage guide – docs/en/ssh-remote/browser-launch-issues.md
Example config files – examples/mcp-config-web.json 및 examples/mcp-config-desktop.json

TL;DR

MCP Feedback Enhanced 는 장시간 작업 중 AI 모델에 인간이 빠르게 피드백을 주기 위한 웹 기반(또는 선택적 데스크톱) UI를 제공하는 MCP 호환 서버입니다. 로컬, SSH 원격, WSL 환경에서 작동하며, 세션 추적, 이미지 및 마크다운 지원, 최근에는 명령 실행 및 WebSocket 가로채기 취약점에 대한 강화가 이루어졌습니다. 어떤 MCP 기반 AI 클라이언트에서도 신뢰성 있고 언어 인식 가능한 인간 개입 체크포인트가 필요할 때 사용하세요.