Mcp フィードバック強化
インタラクティブなユーザーフィードバックとコマンド実行のための強化されたMCPサーバー。AI支援開発において、デュアルインターフェースサポート（Web UIとデスクトップアプリケーション）を備え、インテリジェントな環境検出とクロスプラットフォーム互換性を特徴としています。
概要
MCPフィードバックエンハンスとは？
MCPフィードバックエンハンスは、AI支援開発環境におけるインタラクティブなユーザーフィードバックとコマンド実行を促進するために設計された革新的なサーバーです。このツールは、Web UIとデスクトップアプリケーションの両方を通じてユーザーが参加できるように、デュアルインターフェースをサポートしています。動作環境をインテリジェントに検出するように設計されており、シームレスなクロスプラットフォーム互換性を確保しています。
MCPフィードバックエンハンスの特徴
- デュアルインターフェースサポート：ユーザーはWeb UIとデスクトップアプリケーションのいずれかを選択でき、好みやニーズに応じた柔軟性を提供します。
- インテリジェント環境検出：システムは自動的にユーザーの動作環境を特定し、パフォーマンスと使いやすさを最適化します。
- クロスプラットフォーム互換性：Windows、macOS、Linuxのいずれでも、MCPフィードバックエンハンスは異なるシステムでスムーズに動作します。
- インタラクティブなユーザーフィードバック：このツールは、ユーザーがリアルタイムでフィードバックを提供できるようにし、開発プロセスを向上させ、ユーザー体験を改善します。
- コマンド実行：ユーザーはインターフェースを通じて直接コマンドを実行でき、ワークフローを効率化し、生産性を向上させます。
MCPフィードバックエンハンスの使い方
- インストール：公式リポジトリから自分のオペレーティングシステムに適したバージョンをダウンロードします。
- セットアップ：ドキュメントに記載されたインストール手順に従って、サーバーを自分のマシンにセットアップします。
- アプリケーションを起動：Web UIまたはデスクトップアプリケーションを開いて、サーバーとのインタラクションを開始します。
- フィードバックを提供：アプリケーション内で直接自分の考えや提案を伝えるためにフィードバック機能を使用します。
- コマンドを実行：インターフェースを離れることなく効率的にタスクを実行するためにコマンド実行機能を活用します。
よくある質問
Q: MCPフィードバックエンハンスは無料で使用できますか？
A: はい、MCPフィードバックエンハンスは公開リポジトリであり、無料で使用できます。
Q: MCPフィードバックエンハンスはどのプラットフォームをサポートしていますか？
A: このツールはクロスプラットフォームで設計されており、Windows、macOS、Linuxをサポートしています。
Q: プロジェクトにどのように貢献できますか？
A: 貢献は大歓迎です！リポジトリをフォークし、変更を加えてプルリクエストを提出してください。
Q: ドキュメントはどこで見つけられますか？
A: ドキュメントはリポジトリ内にあり、通常はREADMEファイルまたは専用のdocsフォルダーにあります。
Q: 問題やバグを報告するにはどうすればよいですか？
A: GitHubリポジトリで新しいイシューを開くことで問題を報告できます。遭遇した問題の詳細を提供してください。
MCPフィードバックエンハンスの機能を活用することで、開発者はワークフローを大幅に改善し、AI支援開発における全体的なユーザー体験を向上させることができます。
詳細
MCP Feedback Enhanced
🌐 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 Interface: 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
- AI Call →
mcp-feedback-enhancedtool - Interface Launch → Auto-open desktop application or browser interface (based on configuration)
- Smart Interaction → Prompt selection, text input, image upload, auto-submit
- Real-time Feedback → WebSocket connection delivers information to AI instantly
- Session Tracking → Auto-record session history and statistics
- 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
- Session Management & Tracking: Local file storage, privacy controls, history export, real-time statistics
- 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
- 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"> <img src="docs/en/images/web1.jpeg" width="400" alt="Web UI Main Interface - Prompt Management & Auto Submit" /> </div> <details> <summary>📱 Click to view complete interface screenshots</summary> <div align="center"> <img src="docs/en/images/web2.jpeg" width="800" alt="Web UI Complete Interface - Session Management & Settings" /> </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"> <img src="docs/en/images/desktop1.png" width="600" alt="Desktop Application - Native Cross-platform Desktop Experience" /> </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 imagesCtrl+I（Windows/Linux）/Cmd+I（macOS）：Quick focus input box (Thanks @penn201500)
🚀 Quick Start
1. Installation & Testing
### Install uv (if not already installed)
pip install uv
2. Configure MCP
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"
},
"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
3. Prompt Engineering Setup
For optimal results, add the following rules to your AI assistant:
### MCP Interactive Feedback Rules
follow mcp-feedback-enhanced instructions
⚙️ Advanced Settings
Environment Variables
| 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_WEB_HOST Explanation:
127.0.0.1(default): Local access only, higher security0.0.0.0: Allow remote access, suitable for SSH remote development environments
Testing Options
### Version check
uvx mcp-feedback-enhanced@latest version # Check version
### Interface testing
uvx mcp-feedback-enhanced@latest test --web # Test Web UI (auto continuous running)
uvx mcp-feedback-enhanced@latest test --desktop # Test desktop application (v2.5.0 new feature)
### Debug mode
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
Developer Installation
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync
Local Testing Methods
### Functional testing
make test-func # Standard functional testing
make test-web # Web UI testing (continuous running)
make test-desktop-func # Desktop application functional testing
### Or use direct commands
uv run python -m mcp_feedback_enhanced test # Standard functional testing
uvx --no-cache --with-editable . mcp-feedback-enhanced test --web # Web UI testing (continuous running)
uvx --no-cache --with-editable . mcp-feedback-enhanced test --desktop # Desktop application testing
### Desktop application build (v2.5.0 new feature)
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
### Unit testing
make test # Run all unit tests
make test-fast # Fast testing (skip slow tests)
make test-cov # Test and generate coverage report
### Code quality checks
make check # Complete code quality check
make quick-check # Quick check and auto-fix
Testing Descriptions
- Functional Testing: Test complete MCP tool functionality workflow
- Unit Testing: Test individual module functionality
- Coverage Testing: Generate HTML coverage report to
htmlcov/directory - Quality Checks: Include linting, formatting, type checking
🆕 Version History
📋 Complete Version History: RELEASE_NOTES/CHANGELOG.en.md
Latest Version Highlights (v2.5.5)
- 🌐 SSH Remote Development Support: Added
MCP_WEB_HOSTenvironment variable, completely solving SSH remote development access issues - 🍎 Enhanced macOS Compilation Support: Added PyO3 compilation configuration, supporting Intel and Apple Silicon architectures
- 📝 Tool Documentation Optimization: Moved LLM instructions to tool docstring, improving token efficiency
- 🖥️ Desktop Application MCP Protocol Fix: Fixed MCP protocol communication pollution issues in desktop mode
- 📦 Packaging Process Fix: Fixed multi-platform desktop application packaging and publishing issues
- 🔧 Release Process Optimization: Improved stability of automated release workflows
- 📊 AI Work Summary Markdown Enhancement: Improved Markdown rendering effects and compatibility
- 🔄 Session History Process Optimization: Improved session saving and management mechanisms
🐛 Common Issues
🌐 SSH Remote Environment Issues
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)
- Use default configuration (
MCP_WEB_HOST:127.0.0.1) - Set up SSH port forwarding:
- VS Code Remote SSH: Press
Ctrl+Shift+P→ "Forward a Port" → Enter8765 - Cursor SSH Remote: Manually add port forwarding rule (port 8765)
- VS Code Remote SSH: Press
- 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.
🔧 General Issues
Q: How to use desktop application?
A: v2.5.0 introduces cross-platform desktop application support. Set "MCP_DESKTOP_MODE": "true" in MCP configuration to enable:
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"]
}
}
}
Configuration File Example: examples/mcp-config-desktop.json
Q: How to use legacy PyQt6 GUI interface?
A: v2.4.0 completely removed PyQt6 GUI dependencies. To use legacy GUI, specify v2.3.0 or earlier: uvx mcp-feedback-enhanced@2.3.0
Note: Legacy versions don't include new features (prompt management, auto-submit, session management, desktop application, etc.).
Q: "Unexpected token 'D'" error appears
A: Debug output interference. Set MCP_DEBUG=false or remove the environment variable.
Q: Chinese character garbled text
A: Fixed in v2.0.3. Update to latest version: uvx mcp-feedback-enhanced@latest
Q: Window disappears or positioning errors in multi-screen environment A: Fixed in v2.1.1. Go to "⚙️ Settings" tab, check "Always show window at primary screen center" to resolve. Especially suitable for T-shaped screen arrangements and other complex multi-screen configurations.
Q: Image upload failure A: Check file format (PNG/JPG/JPEG/GIF/BMP/WebP). System supports any size image files.
Q: Web UI cannot start A: Check firewall settings or try using different ports.
Q: UV Cache occupies too much disk space
A: Due to frequent use of uvx commands, cache may accumulate to tens of GB. Regular cleanup recommended:
### View cache size and detailed information
python scripts/cleanup_cache.py --size
### Preview cleanup content (no actual cleanup)
python scripts/cleanup_cache.py --dry-run
### Execute standard cleanup
python scripts/cleanup_cache.py --clean
### Force cleanup (attempts to close related programs, solving Windows file occupation issues)
python scripts/cleanup_cache.py --force
### Or directly use uv command
uv cache clean
For detailed instructions, refer to: Cache Management Guide
Q: AI models cannot parse images A: Various AI models (including Gemini Pro 2.5, Claude, etc.) may have instability in image parsing, sometimes correctly recognizing and sometimes unable to parse uploaded image content. This is a known limitation of AI visual understanding technology. Recommendations:
- Ensure good image quality (high contrast, clear text)
- Try uploading multiple times, retries usually succeed
- If parsing continues to fail, try adjusting image size or format
🙏 Acknowledgments
🌟 Support Original Author
Fábio Ferreira - X @fabiomlferreira Original Project: noopstudios/interactive-feedback-mcp
If you find it useful, please:
Design Inspiration
sanshao85 - mcp-feedback-collector
Contributors
penn201500 - GitHub @penn201500
- 🎯 Auto-focus input box feature (PR #39)
leo108 - GitHub @leo108
- 🌐 SSH Remote Development Support (
MCP_WEB_HOSTenvironment variable) (PR #113)
Alsan - GitHub @Alsan
- 🍎 macOS PyO3 Compilation Configuration Support (PR #93)
fireinice - GitHub @fireinice
- 📝 Tool Documentation Optimization (LLM instructions moved to docstring) (PR #105)
Community Support
- Discord: https://discord.gg/Gur2V67
- Issues: GitHub Issues
📄 License
MIT License - See LICENSE file for details
📈 Star History
🌟 Welcome to Star and share with more developers!
サーバー設定
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": [
"mcp-feedback-enhanced@latest"
],
"timeout": 600,
"autoApprove": [
"interactive_feedback"
]
}
}
}
