Interactive Feedback MCP - 交互式反馈收集器

by bulice

5 stars
236 downloads
Not rated
GitHub

About

Interactive Feedback MCP Server - A tool for collecting user feedback with PySide6 interface

Details

Author
bulice
GitHub stars
5
Downloads
236
Categories
Other

- Two-way text feedback with AI assistants via a GUI
- Multi-image upload or clipboard paste support
- Real-time command execution with live output and process monitoring
- Dark and light theme switching with responsive design
- Project-specific configuration persistence using Qt QSettings
- Command history and auto-execute on startup option

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Interactive Feedback MCP - 交互式反馈收集器
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with uv sync or pip install -r requirements.txt, then run uv run server.py or python server.py. Configure the server in your AI tool’s MCP settings (e.g., Cursor’s mcpServers JSON) with the path to mcp_server.sh. The AI assistant can call the interactive_feedback tool to prompt the user for input.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "interactive feedback mcp - \u4ea4\u4e92\u5f0f\u53cd\u9988\u6536\u96c6\u5668": {
            "interactive-feedback-mcp": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "interactive-feedback-mcp": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

Interactive Feedback MCP - 交互式反馈收集器

> 基于 Fábio Ferreira (@fabiomlferreira) 的原始项目进行二次开发
> 参考项目:sanshao85/mcp-feedback-collector
> 当前维护者:bulice
> 更多 AI 开发增强工具请访问 dotcursorrules.com

📖 项目概述

Interactive Feedback MCP 是一个基于 MCP (Model Context Protocol) 的服务器,专为 AI 辅助开发工具(如 CursorClineWindsurf)设计的人机交互反馈系统。

本项目基于 Fábio Ferreira 的原始设计进行了二次开发和优化,同时参考了 sanshao85/mcp-feedback-collector 项目的现代化实现,通过提供图形化界面,让用户能够在 AI 开发过程中实时提供文字反馈、上传图片、执行命令并查看输出,从而实现真正的人机协作开发模式。

✨ 核心功能

🎯 交互式反馈

- 📝 文字反馈: 提供详细的文本反馈给 AI 助手 - 🖼️ 图片支持: 支持多图片上传或剪贴板粘贴 - 💬 实时交互: 与 AI 助手进行实时对话和反馈

🎨 用户界面

- 🌙 深色主题: 护眼的深色界面,适合长时间使用 - ☀️ 浅色主题: 清爽的浅色界面,适合明亮环境 - 🎛️ 主题切换: 支持动态切换界面主题 - 📱 响应式设计: 自适应窗口大小和布局

⚙️ 命令执行

- 🔄 实时输出: 实时显示命令执行结果 - 📊 进程监控: 监控命令执行状态和进程信息 - 🚀 自动执行: 可选的启动时自动执行命令 - 💾 命令历史: 保存和管理常用命令

🗂️ 项目管理

- 📁 项目特定设置: 每个项目独立保存配置 - ⚙️ 配置持久化: 使用 Qt QSettings 保存用户偏好 - 🔧 灵活配置: 支持多种启动和配置方式

🏗️ 技术架构

核心技术栈

- Python 3.11+: 主要开发语言 - FastMCP: MCP 服务器框架 - PySide6: 跨平台 GUI 框架 - psutil: 系统进程管理 - Pillow: 图像处理库

项目结构

interactive-feedback-mcp/
├── server.py              # MCP 服务器主程序
├── feedback_ui.py          # GUI 界面实现
├── diagnose_mcp.py         # MCP 连接诊断工具
├── test_mcp.py            # MCP 服务器测试脚本
├── mcp_server.sh          # 服务器启动脚本
├── requirements.txt       # Python 依赖包
├── pyproject.toml         # 项目配置文件
├── cursor_mcp_config.json # Cursor 配置示例
├── images/                # 图片资源目录
├── logs/                  # 日志文件目录
└── README.md              # 项目说明文档

核心组件

1. MCP 服务器 (server.py)

- 实现 MCP 协议的服务器端 - 提供 interactive_feedbackget_image_info 工具 - 处理与 AI 助手的通信

2. GUI 界面 (feedback_ui.py)

- 基于 PySide6 的现代化界面 - 支持深色/浅色主题切换 - 实现文字输入、图片上传、命令执行等功能

3. 诊断工具 (diagnose_mcp.py)

- 检查 MCP 服务器连接状态 - 验证依赖和配置 - 生成配置建议

🚀 安装配置

系统要求

- Python: 3.11 或更高版本 - 操作系统: Windows、macOS、Linux - 包管理器: uv (推荐) 或 pip

安装步骤

1. 获取代码

git clone https://github.com/bulice/interactive-feedback-mcp.git
cd interactive-feedback-mcp

2. 安装依赖

```bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.