mcp-feedback-collector

# 🎯 MCP Feedback Collector A modern Model Context Protocol (MCP) server for interactive user feedback collection for AI assistants.    ## Configuration in Cursor Rules “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. mcp-feedback-collector.collect_feedback ” ## Related Tutorial Links YouTube: https://youtu.be/aYtGm1xHNXI Bilibili: https://www.bilibili.com/video/BV1J6jyzQE8P/ ## Node.js Version Available https://github.com/sanshao85/mcp-feedback-collector-web Supports remote server usage for a more powerful experience! ## ✨ Main Features - 🎨 **Modern Interface** - Aesthetic 700x800 pixel GUI, supports multiple languages - 📷 **Multi-Image Support** - Select multiple images at once, supports file selection and clipboard paste - 💬 **Flexible Feedback** - Supports pure text, pure image, or text + image combination feedback - ⚡ **Zero-Configuration Installation** - One-click installation with uvx, no complex configuration required - 🔧 **Smart Timeout** - Configurable dialog timeout to avoid operation interruption ## 🚀 Quick Start ### 1. Install uvx ```bash pip install uvx ``` ### 2. Configure Claude Desktop Add the following to `claude_desktop_config.json`: ```json { "mcpServers": { "mcp-feedback-collector": { "command": "uvx", "args": ["mcp-feedback-collector"], "env": { "PYTHONIOENCODING": "utf-8", "MCP_DIALOG_TIMEOUT": "600" } } } } ``` ### 3. Restart Claude Desktop Restart Claude Desktop after configuration to use. ## 🛠️ Core Functions ### collect_feedback() The main tool for collecting user feedback, AI can report work content, and users provide text and image feedback. ```python # AI call example result = collect_feedback("I have completed the code optimization work...") ``` ### pick_image() Quick image selection tool for single-image selection scenarios. ### get_image_info() Get detailed information about image files (format, size, dimensions, etc.). ## 🖼️ Interface Preview ``` 🎯 Work Completion Report and Feedback Collection ┌─────────────────────────────────────────┐ │ 📋 AI Work Completion Report │ │ ┌─────────────────────────────────────┐ │ │ │ [AI reported work content displayed here] │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────┘ ┌─────────────────────────────────────────┐ │ 💬 Your Text Feedback (Optional) │ │ ┌─────────────────────────────────────┐ │ │ │ [Multi-line text input area] │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────┘ ┌─────────────────────────────────────────┐ │ 🖼️ Image Feedback (Optional, supports multiple) │ │ [📁 Select File] [📋 Paste] [❌ Clear] │ │ [Image thumbnail preview area] │ └─────────────────────────────────────────┘ [✅ Submit Feedback] [❌ Cancel] ``` ## ⚙️ Configuration Instructions ### Timeout Settings - `MCP_DIALOG_TIMEOUT`: Dialog wait time (seconds) - Default: 300 seconds (5 minutes) - Recommended: 600 seconds (10 minutes) - Complex operations: 1200 seconds (20 minutes) ### Supported Image Formats PNG, JPG, JPEG, GIF, BMP, WebP ## 💡 Use Cases - ✅ Collect user evaluations after AI completes tasks - ✅ Collect detailed feedback with screenshots - ✅ Get user opinions on code/design - ✅ Collect bug reports and improvement suggestions ## 🔧 Technical Stack - **MCP Framework**: FastMCP - **GUI**: tkinter + PIL - **Multi-Threading**: threading + queue - **Image Processing**: Pillow ## 📝 Update Log ### v2.0.0 (2025-05-28) - 🎨 New modern UI design - 📷 Support for submitting multiple images simultaneously - 🖼️ Horizontal scrolling image preview - 💫 Colorful buttons and icons - 🔧 Optimized user experience ## 📄 License MIT License - See [LICENSE](LICENSE) file for details ## 🤝 Contribution Feel free to submit issues and pull requests! --- **Make AI interaction with users more efficient and intuitive!** 🎯 ## Thanks for Support https://api.ssopen.top/ API gateway, 290+ AI large models, official cost one-seventh, supports high concurrency!