Skip to content
Back to search

mcp-feedback-collector

一个现代化的 Model Context Protocol (MCP) 服务器,为AI助手提供交互式用户反馈收集功能。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sanshao85--mcp-feedback-collector/badge.svg)](/listings/sanshao85--mcp-feedback-collector)

HTML

<a href="/listings/sanshao85--mcp-feedback-collector"><img src="/api/listings/sanshao85--mcp-feedback-collector/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 147 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🎯 MCP反馈收集器
  2. 一个现代化的 Model Context Protocol (MCP) 服务器,为AI助手提供交互式用户反馈收集功能。
  3. ![Version](https://img.shields.io/badge/version-2.0.0-blue)
  4. ![Python](https://img.shields.io/badge/python-3.8+-green)
  5. ![License](https://img.shields.io/badge/license-MIT-orange)
  6. ## 在cursor规则中可以下面这样配置
  7. “Whenever you want to ask a question, always call the MCP .
  8. 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 ”
  9. ## 相关教程链接
  10. 油管:https://youtu.be/aYtGm1xHNXI
  11. B站:https://www.bilibili.com/video/BV1J6jyzQE8P/
  12. ## 已经推出了nodejs的版本
  13. https://github.com/sanshao85/mcp-feedback-collector-web
  14. 支持远程服务器使用,体验更强大!
  15. ## ✨ 主要特性
  16. - 🎨 **现代化界面** - 美观的700x800像素GUI,支持中文界面
  17. - 📷 **多图片支持** - 同时选择多张图片,支持文件选择和剪贴板粘贴
  18. - 💬 **灵活反馈** - 支持纯文字、纯图片或文字+图片组合反馈
  19. - ⚡ **零配置安装** - 使用uvx一键安装,无需复杂配置
  20. - 🔧 **智能超时** - 可配置的对话框超时时间,避免操作中断
  21. ## 🚀 快速开始
  22. ### 1. 安装uvx
  23. ```bash
  24. pip install uvx
  25. ```
  26. ### 2. 配置Claude Desktop
  27. 在 `claude_desktop_config.json` 中添加:
  28. ```json
  29. {
  30. "mcpServers": {
  31. "mcp-feedback-collector": {
  32. "command": "uvx",
  33. "args": ["mcp-feedback-collector"],
  34. "env": {
  35. "PYTHONIOENCODING": "utf-8",
  36. "MCP_DIALOG_TIMEOUT": "600"
  37. }
  38. }
  39. }
  40. }
  41. ```
  42. ### 3. 重启Claude Desktop
  43. 配置完成后重启Claude Desktop即可使用。
  44. ## 🛠️ 核心功能
  45. ### collect_feedback()
  46. 收集用户反馈的主要工具,AI可以汇报工作内容,用户提供文字和图片反馈。
  47. ```python
  48. # AI调用示例
  49. result = collect_feedback("我已经完成了代码优化工作...")
  50. ```
  51. ### pick_image()
  52. 快速图片选择工具,用于单张图片选择场景。
  53. ### get_image_info()
  54. 获取图片文件的详细信息(格式、尺寸、大小等)。
  55. ## 🖼️ 界面预览
  56. ```
  57. 🎯 工作完成汇报与反馈收集
  58. ┌─────────────────────────────────────────┐
  59. │ 📋 AI工作完成汇报 │
  60. │ ┌─────────────────────────────────────┐ │
  61. │ │ [AI汇报的工作内容显示在这里] │ │
  62. │ └─────────────────────────────────────┘ │
  63. └─────────────────────────────────────────┘
  64. ┌─────────────────────────────────────────┐
  65. │ 💬 您的文字反馈(可选) │
  66. │ ┌─────────────────────────────────────┐ │
  67. │ │ [多行文本输入区域] │ │
  68. │ └─────────────────────────────────────┘ │
  69. └─────────────────────────────────────────┘
  70. ┌─────────────────────────────────────────┐
  71. │ 🖼️ 图片反馈(可选,支持多张) │
  72. │ [📁选择文件] [📋粘贴] [❌清除] │
  73. │ [图片缩略图预览区域] │
  74. └─────────────────────────────────────────┘
  75. [✅ 提交反馈] [❌ 取消]
  76. ```
  77. ## ⚙️ 配置说明
  78. ### 超时设置
  79. - `MCP_DIALOG_TIMEOUT`: 对话框等待时间(秒)
  80. - 默认:300秒(5分钟)
  81. - 建议:600秒(10分钟)
  82. - 复杂操作:1200秒(20分钟)
  83. ### 支持的图片格式
  84. PNG、JPG、JPEG、GIF、BMP、WebP
  85. ## 💡 使用场景
  86. - ✅ AI完成任务后收集用户评价
  87. - ✅ 收集包含截图的详细反馈
  88. - ✅ 获取用户对代码/设计的意见
  89. - ✅ 收集bug报告和改进建议
  90. ## 🔧 技术栈
  91. - **MCP框架**: FastMCP
  92. - **GUI**: tkinter + PIL
  93. - **多线程**: threading + queue
  94. - **图片处理**: Pillow
  95. ## 📝 更新日志
  96. ### v2.0.0 (2025-05-28)
  97. - 🎨 全新现代化UI设计
  98. - 📷 多图片同时提交支持
  99. - 🖼️ 横向滚动图片预览
  100. - 💫 彩色按钮和图标
  101. - 🔧 优化用户体验
  102. ## 📄 许可证
  103. MIT License - 详见 [LICENSE](LICENSE) 文件
  104. ## 🤝 贡献
  105. 欢迎提交Issue和Pull Request!
  106. ---
  107. **让AI与用户的交互更高效直观!** 🎯
  108. ## 感谢支持
  109. https://api.ssopen.top/ API中转站,290+AI 大模型,官方成本七分之一,支持高并发!

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.