Interactive Feedback MCP

Instructions

Implementation Reference

• server.py:84-114 (handler)

  The primary handler for the 'interactive_feedback' MCP tool. Decorated with @mcp.tool() for automatic registration and schema generation via Pydantic Fields. Collects user feedback by launching a subprocess UI and returns structured response with text and base64-encoded images.
  @mcp.tool() def interactive_feedback( message: str = Field(description="向用户提出的具体问题"), predefined_options: list = Field(default=None, description="提供给用户选择的预定义选项（可选）"), ) -> Dict[str, str | List[Dict[str, str]]]: """向用户请求交互式反馈，支持文本和图片""" # 如果没有提供预定义选项，使用默认选项 predefined_options_list = predefined_options if isinstance(predefined_options, list) else None # 确保预定义选项列表不为空 if not predefined_options_list: predefined_options_list = [ "已解决当前问题", "进一步优化程序", "进一步优化界面", "还有一些问题需要修复", "没有修复任何错误", ] result = launch_feedback_ui(message, predefined_options_list) # 构建返回结果 response = { 'interactive_feedback': result.get('interactive_feedback', '') } # 如果有图片，添加到返回结果中 if 'images' in result and result['images']: response['images'] = result['images'] return response
• server.py:19-82 (helper)

  Helper utility that launches the feedback_ui.py script as a subprocess using temporary JSON file for communication, processes attached images by converting them to base64, and returns the feedback data.
  def launch_feedback_ui(summary: str, predefinedOptions: list[str] | None = None) -> dict[str, str | list[str]]: # 为反馈结果创建一个临时文件 with tempfile.NamedTemporaryFile(suffix=".json", delete=False) as tmp: output_file = tmp.name try: # 获取相对于此脚本的feedback_ui.py路径 script_dir = os.path.dirname(os.path.abspath(__file__)) feedback_ui_path = os.path.join(script_dir, "feedback_ui.py") # 作为单独的进程运行feedback_ui.py # 注意：uv似乎有一个bug，所以我们需要 # 传递一堆特殊标志来使其工作 args = [ sys.executable, "-u", feedback_ui_path, "--prompt", summary, "--output-file", output_file, "--predefined-options", "|||".join(predefinedOptions) if predefinedOptions else "" ] result = subprocess.run( args, check=False, shell=False, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, stdin=subprocess.DEVNULL, close_fds=True ) if result.returncode != 0: raise Exception(f"启动反馈UI失败: {result.returncode}") # 从临时文件读取结果 with open(output_file, 'r') as f: result_data = json.load(f) os.unlink(output_file) # 处理图片路径，将图片转换为base64 if 'image_paths' in result_data and result_data['image_paths']: image_data = [] for img_path in result_data['image_paths']: if os.path.exists(img_path): try: with open(img_path, 'rb') as img_file: img_content = img_file.read() img_base64 = base64.b64encode(img_content).decode('utf-8') img_filename = os.path.basename(img_path) image_data.append({ 'filename': img_filename, 'content': img_base64, 'path': img_path }) except Exception as e: print(f"处理图片时出错: {e}") # 添加图片数据到结果中 result_data['images'] = image_data return result_data except Exception as e: if os.path.exists(output_file): os.unlink(output_file) raise e
• feedback_ui.py:22-25 (schema)

  Type definition for the feedback result structure used by the UI, specifying the 'interactive_feedback' field and list of image paths.
  class FeedbackResult(TypedDict): interactive_feedback: str image_paths: List[str]