Mcp Feedback Enhanced
About
# MCP Feedback Enhanced **🌐 Language / 語言切換:** **English** | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) **Original Author:** [Fábio Ferreira](https://x.com/fabiomlferreira) | [Original Project](https://github.com/noopstudios/interactive-feedback-mcp) ⭐ **Enhanced Fork:**…
Explore
<div align="center">
</div>
Desktop Application - Native cross-platform desktop application based on Tauri framework, supporting Windows, macOS, Linux with exactly the same functionality as Web UI
Shortcut Support
- Ctrl+Enter（Windows/Linux）/ Cmd+Enter（macOS）：Submit feedback (both main keyboard and numeric keypad supported)
- Ctrl+V（Windows/Linux）/ Cmd+V（macOS）：Direct paste clipboard images
- Ctrl+I（Windows/Linux）/ Cmd+I（macOS）：Quick focus input box (Thanks @penn201500)
make build-desktop # Build desktop application (debug mode)
make build-desktop-release # Build desktop application (release mode)
make test-desktop # Test desktop application
make clean-desktop # Clean desktop build artifacts
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp Feedback EnhancedCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install uv
Basic Configuration (suitable for most users):
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}
Advanced Configuration (requires custom environment):
{
"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"]
}
}
}
Desktop Application Configuration (v2.5.0 new feature - using native desktop application):
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_HOST": "127.0.0.1",
"MCP_WEB_PORT": "8765",
"MCP_DEBUG": "false"
},
"autoApprove": ["interactive_feedback"]
}
}
}
Configuration File Examples:
- Desktop Mode: examples/mcp-config-desktop.json
- Web Mode: examples/mcp-config-web.json
For optimal results, add the following rules to your AI assistant:
| Variable | Purpose | Values | Default |
|----------|---------|--------|---------|
| MCP_DEBUG | Debug mode | true/false | false |
| MCP_WEB_HOST | Web UI host binding | IP address or hostname | 127.0.0.1 |
| MCP_WEB_PORT | Web UI port | 1024-65535 | 8765 |
| MCP_DESKTOP_MODE | Desktop application mode | true/false | false |
| MCP_LANGUAGE | Force UI language | zh-TW/zh-CN/en | Auto-detect |
MCP_WEB_HOST Explanation:
- 127.0.0.1 (default): Local access only, higher security
- 0.0.0.0: Allow remote access, suitable for SSH remote development environments
MCP_LANGUAGE Explanation:
- Used to force the interface language, overriding automatic system detection
- Supported language codes:
- zh-TW: Traditional Chinese
- zh-CN: Simplified Chinese
- en: English
- Language detection priority:
1. User-saved language settings in the interface (highest priority)
2. MCP_LANGUAGE environment variable
3. System environment variables (LANG, LC_ALL, etc.)
4. System default language
5. Fallback to default language (Traditional Chinese)
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync
Local Testing Methods
Q: Browser cannot launch or access in SSH Remote environment
A: Two solutions available:
Solution 1: Environment Variable Setting (v2.5.5 Recommended)
Set "MCP_WEB_HOST": "0.0.0.0" in MCP configuration to allow remote access:
{
"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"]
}
}
}
Then open in local browser:
http://[remote-host-IP]:8765
Solution 2: SSH Port Forwarding (Traditional Method)
1. Use default configuration (MCP_WEB_HOST: 127.0.0.1)
2. Set up SSH port forwarding:
- VS Code Remote SSH: Press Ctrl+Shift+P → "Forward a Port" → Enter 8765
- Cursor SSH Remote: Manually add port forwarding rule (port 8765)
3. Open in local browser: http://localhost:8765
For detailed solutions, refer to: SSH Remote Environment Usage Guide
Q: Why am I not receiving new MCP feedback?
A: Likely a WebSocket connection issue. Solution: Directly refresh the browser page.
Q: Why isn't MCP being called?
A: Please confirm MCP tool status shows green light. Solution: Repeatedly toggle MCP tool on/off, wait a few seconds for system reconnection.
Q: Augment cannot start MCP
A: Solution: Completely close and restart VS Code or Cursor, reopen the project.
interactive_feedback
Interactive feedback collection tool for LLM agents. USAGE RULES: 1. During any process, task, or conversation, whether asking, replying, or completing phased tasks, you must call this tool to ask for feedback. 2. Unless receiving termination instructions, all steps must repeatedly call this tool. 3. Whenever user feedback is received, if the feedback content is not empty, you must call this tool again and adjust behavior based on the feedback content. 4. Only when the user explicitly indicates "end" or "no more interaction needed" can you stop calling this tool, and the process is considered complete. 5. You should summarize what have done, and provide project directory through args to let user know what you have done to provide feedback for next step. Args: project_directory: Project directory path for context summary: Summary of AI work completed for user review timeout: Timeout in seconds for waiting user feedback (default: 600 seconds) Returns: list: List containing TextContent and MCPImage objects representing user feedback
get_system_info
獲取系統環境資訊 Returns: str: JSON 格式的系統資訊
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp feedback enhanced": {
"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,
"autoApprove": [
"interactive_feedback"
]
}
}🌐 Language / 語言切換: English | 繁體中文 | 简体中文
Original Author: Fábio Ferreira | Original Project ⭐
Enhanced Fork: Minidoracat
UI Design Reference: sanshao85/mcp-feedback-collector
🎯 Core Concept
This is an MCP server that establishes feedback-oriented development workflows, providing Web UI and Desktop Application dual interface options, perfectly adapting to local, SSH Remote environments, and WSL (Windows Subsystem for Linux) environments. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency.
🌐 Dual Interface Architecture Advantages:
- 🖥️ Desktop Application: Native cross-platform desktop experience, supporting Windows, macOS, Linux
- 🌐 Web UI: No GUI dependencies required, suitable for remote and WSL environments
- 🔧 Flexible Deployment: Choose the most suitable interface mode based on environment requirements
- 📦 Unified Functionality: Both interfaces provide exactly the same functional experience
🖥️ Desktop Application: v2.5.0 introduces cross-platform desktop application support based on Tauri framework, supporting Windows, macOS, and Linux platforms with native desktop experience.
Supported Platforms: Cursor | Cline | Windsurf | Augment | Trae
🔄 Workflow
1. AI Call →mcp-feedback-enhanced tool
2. Interface Launch → Auto-open desktop application or browser interface (based on configuration)
3. Smart Interaction → Prompt selection, text input, image upload, auto-submit
4. Real-time Feedback → WebSocket connection delivers information to AI instantly
5. Session Tracking → Auto-record session history and statistics
6. Process Continuation → AI adjusts behavior or ends task based on feedback
🌟 Key Features
🖥️ Dual Interface Support
- Desktop Application: Cross-platform native application based on Tauri, supporting Windows, macOS, Linux - Web UI Interface: Lightweight browser interface suitable for remote and WSL environments - Automatic Environment Detection: Intelligently recognizes SSH Remote, WSL and other special environments - Unified Feature Experience: Both interfaces provide exactly the same functionality📝 Smart Workflow
- Prompt Management: CRUD operations for common prompts, usage statistics, intelligent sorting - Auto-Timed Submit: 1-86400 second flexible timer, supports pause, resume, cancel with new pause/resume button controls - Auto Command Execution (v2.6.0): Automatically execute preset commands after creating new sessions or commits for improved development efficiency - Session Management & Tracking: Local file storage, privacy controls, history export (supports JSON, CSV, Markdown formats), real-time statistics, flexible timeout settings - Connection Monitoring: WebSocket status monitoring, auto-reconnection, quality indicators - AI Work Summary Markdown Display: Support for rich Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats for enhanced content readability🎨 Modern Experience
- Responsive Design: Adapts to different screen sizes, modular JavaScript architecture - Audio Notifications: Built-in multiple sound effects, custom audio upload support, volume control - System Notifications (v2.6.0): System-level real-time alerts for important events (like auto-commit, session timeout) - Smart Memory: Input box height memory, one-click copy, persistent settings - Multi-language Support: Traditional Chinese, English, Simplified Chinese, instant switching🖼️ Images & Media
- Full Format Support: PNG, JPG, JPEG, GIF, BMP, WebP - Convenient Upload: Drag & drop files, clipboard paste (Ctrl+V) - Unlimited Processing: Support for any size images, automatic intelligent processing🌐 Interface Preview
Web UI Interface (v2.5.0 - Desktop Application Support)
<div align="center">
</div>
<details>
<summary>📱 Click to view complete interface screenshots</summary>
<div align="center">
</div>
</details>
Web UI Interface - Supports desktop application and Web interface, providing prompt management, auto-submit, session tracking and other smart features
Desktop Application Interface (v2.5.0 New Feature)
<div align="center">
</div>
Desktop Application - Native cross-platform desktop application based on Tauri framework, supporting Windows, macOS, Linux with exactly the same functionality as Web UI
Shortcut Support
- Ctrl+Enter（Windows/Linux）/ Cmd+Enter（macOS）：Submit feedback (both main keyboard and numeric keypad supported)
- Ctrl+V（Windows/Linux）/ Cmd+V（macOS）：Direct paste clipboard images
- Ctrl+I（Windows/Linux）/ Cmd+I（macOS）：Quick focus input box (Thanks @penn201500)
🚀 Quick Start
1. Installation & Testing
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
