MCP反馈收集器

Um servidor MCP para coletar feedback interativo do usuário por meio de uma interface gráfica.

GitHub
1

Documentação

🎯 MCP反馈收集器

Um servidor moderno de Model Context Protocol (MCP) que fornece funcionalidade interativa de coleta de feedback do usuário para assistentes de IA.

Version Python License

Nas regras do cursor, você pode configurar da seguinte forma

"Sempre que quiser fazer uma pergunta, chame o MCP.

Sempre que estiver prestes a concluir uma solicitação do usuário, chame o MCP em vez de simplesmente encerrar o processo. Continue chamando o MCP até que o feedback do usuário esteja vazio e, em seguida, encerre a solicitação. mcp-feedback-collector.collect_feedback "

Links de tutoriais relacionados

YouTube: https://youtu.be/aYtGm1xHNXI Bilibili: https://www.bilibili.com/video/BV1J6jyzQE8P/

✨ Principais recursos

  • 🎨 Interface moderna - GUI bonita de 700x800 pixels, com suporte a interface em chinês, janela centralizada e sempre no topo
  • ⌨️ Interação aprimorada por teclado - Suporte a Enter para enviar, Esc para cancelar, Ctrl+V para colar imagens diretamente
  • 📷 Suporte a múltiplas imagens - Selecione várias imagens ao mesmo tempo, com suporte a seleção de arquivos e colagem da área de transferência
  • 💬 Feedback flexível - Suporte a feedback somente texto, somente imagem ou combinação de texto + imagem
  • ⚡ Instalação sem configuração - Instalação com um clique usando uvx, sem necessidade de configuração complexa
  • 🔧 Timeout inteligente - Tempo de timeout configurável para a caixa de diálogo, evitando interrupções de operação

🚀 Início rápido

1. Instalar uvx

pip install uvx

2. Configurar o Claude Desktop

Adicione em claude_desktop_config.json:

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

3. Reiniciar o Claude Desktop

Após a configuração, reinicie o Claude Desktop para usar.

🛠️ Funcionalidades principais

collect_feedback()

Ferramenta principal para coletar feedback do usuário. A IA pode relatar o conteúdo do trabalho e o usuário fornece feedback em texto e imagens.

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

pick_image()

Ferramenta rápida de seleção de imagens, usada para cenários de seleção de uma única imagem.

get_image_info()

Obtém informações detalhadas do arquivo de imagem (formato, dimensões, tamanho, etc.).

🖼️ Pré-visualização da interface

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

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

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

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

⚙️ Instruções de configuração

Configuração de timeout

  • MCP_DIALOG_TIMEOUT: Tempo de espera da caixa de diálogo (segundos)
    • Padrão: 300 segundos (5 minutos)
    • Recomendado: 600 segundos (10 minutos)
    • Operações complexas: 1200 segundos (20 minutos)

Formatos de imagem suportados

PNG, JPG, JPEG, GIF, BMP, WebP

💡 Casos de uso

  • ✅ Coletar avaliações do usuário após a IA concluir tarefas
  • ✅ Coletar feedback detalhado com capturas de tela
  • ✅ Obter opiniões do usuário sobre código/design
  • ✅ Coletar relatórios de bugs e sugestões de melhoria

🔧 Pilha tecnológica

  • Framework MCP: FastMCP
  • GUI: tkinter + PIL
  • Multithreading: threading + queue
  • Processamento de imagens: Pillow

📝 Registro de alterações

v2.0.0 (2025-05-28)

  • 🎨 Novo design de UI moderno
  • 📷 Suporte a envio de múltiplas imagens simultaneamente
  • 🖼️ Pré-visualização de imagens com rolagem horizontal
  • 💫 Botões coloridos e ícones
  • 🔧 Experiência do usuário otimizada

📄 Licença

Licença MIT - Consulte o arquivo LICENSE

🤝 Contribuições

Contribuições com Issues e Pull Requests são bem-vindas!

Torne a interação entre IA e usuários mais eficiente e intuitiva! 🎯

Agradecimento pelo apoio

https://api.ssopen.top/ Estação de retransmissão de API, 290+ modelos de IA de grande porte, um sétimo do custo oficial, suporte a alta concorrência!