Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Feedback Collector

FreeNot checked

A MCP server that enables AI assistants to collect interactive user feedback with text and image support via a modern GUI.

GitHubEmbed

About

A MCP server that enables AI assistants to collect interactive user feedback with text and image support via a modern GUI.

README

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

Version Python License

在cursor规则中可以下面这样配置

“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 ”

相关教程链接

油管:https://youtu.be/aYtGm1xHNXI B站:https://www.bilibili.com/video/BV1J6jyzQE8P/

已经推出了nodejs的版本

https://github.com/sanshao85/mcp-feedback-collector-web 支持远程服务器使用,体验更强大!

✨ 主要特性

  • 🎨 现代化界面 - 美观的700x800像素GUI,支持中文界面
  • 📷 多图片支持 - 同时选择多张图片,支持文件选择和剪贴板粘贴
  • 💬 灵活反馈 - 支持纯文字、纯图片或文字+图片组合反馈
  • 零配置安装 - 使用uvx一键安装,无需复杂配置
  • 🔧 智能超时 - 可配置的对话框超时时间,避免操作中断

🚀 快速开始

1. 安装uvx

pip install uvx

2. 配置Claude Desktop

claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "mcp-feedback-collector": {
      "command": "uvx",
      "args": ["mcp-feedback-collector"],
      "env": {
        "PYTHONIOENCODING": "utf-8",
        "MCP_DIALOG_TIMEOUT": "600"
      }
    }
  }
}

3. 重启Claude Desktop

配置完成后重启Claude Desktop即可使用。

🛠️ 核心功能

collect_feedback()

收集用户反馈的主要工具,AI可以汇报工作内容,用户提供文字和图片反馈。

# AI调用示例
result = collect_feedback("我已经完成了代码优化工作...")

pick_image()

快速图片选择工具,用于单张图片选择场景。

get_image_info()

获取图片文件的详细信息(格式、尺寸、大小等)。

🖼️ 界面预览

🎯 工作完成汇报与反馈收集
┌─────────────────────────────────────────┐
│ 📋 AI工作完成汇报                        │
│ ┌─────────────────────────────────────┐ │
│ │ [AI汇报的工作内容显示在这里]         │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ 💬 您的文字反馈(可选)                  │
│ ┌─────────────────────────────────────┐ │
│ │ [多行文本输入区域]                   │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ 🖼️ 图片反馈(可选,支持多张)            │
│ [📁选择文件] [📋粘贴] [❌清除]           │
│ [图片缩略图预览区域]                     │
└─────────────────────────────────────────┘

[✅ 提交反馈]  [❌ 取消]

⚙️ 配置说明

超时设置

  • MCP_DIALOG_TIMEOUT: 对话框等待时间(秒)
    • 默认:300秒(5分钟)
    • 建议:600秒(10分钟)
    • 复杂操作:1200秒(20分钟)

支持的图片格式

PNG、JPG、JPEG、GIF、BMP、WebP

💡 使用场景

  • ✅ AI完成任务后收集用户评价
  • ✅ 收集包含截图的详细反馈
  • ✅ 获取用户对代码/设计的意见
  • ✅ 收集bug报告和改进建议

🔧 技术栈

  • MCP框架: FastMCP
  • GUI: tkinter + PIL
  • 多线程: threading + queue
  • 图片处理: Pillow

📝 更新日志

v2.0.0 (2025-05-28)

  • 🎨 全新现代化UI设计
  • 📷 多图片同时提交支持
  • 🖼️ 横向滚动图片预览
  • 💫 彩色按钮和图标
  • 🔧 优化用户体验

📄 许可证

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎提交Issue和Pull Request!


让AI与用户的交互更高效直观! 🎯

感谢支持

https://api.ssopen.top/ API中转站,290+AI 大模型,官方成本七分之一,支持高并发!

from github.com/sanshao85/mcp-feedback-collector

Install Feedback Collector in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install mcp-feedback-collector

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add mcp-feedback-collector -- uvx mcp-feedback-collector

FAQ

Is Feedback Collector MCP free?

Yes, Feedback Collector MCP is free — one-click install via Unyly at no cost.

Does Feedback Collector need an API key?

No, Feedback Collector runs without API keys or environment variables.

Is Feedback Collector hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Feedback Collector in Claude Desktop, Claude Code or Cursor?

Open Feedback Collector on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Feedback Collector with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All media MCPs