关键词

用户反馈图片反馈LLM工具桌面应用交互

项目简介

Feedback Collector MCP 工具是一个Model Context Protocol (MCP) 服务器实现，它扩展了LLM（大型语言模型）与用户交互的能力。通过启动一个桌面Electron应用，它允许用户以图形界面方式提供带有文本和图片的反馈信息，并将这些信息结构化地返回给LLM客户端。

主要功能点

  • 文本反馈: 用户可以在桌面应用窗口中输入文本反馈。
  • 图片支持: 支持用户通过文件选择、拖放或粘贴板粘贴的方式上传图片作为反馈的一部分。
  • 快速回复按钮: 提供“Submit”、“Approve”、“Enough”、“Cancel”等按钮，方便用户快速响应。
  • 时间信息: 可配置包含反馈发生时的时间信息，支持多种格式和时区。
  • 桌面应用交互: 提供比纯文本交互更丰富的用户体验，尤其适合收集复杂反馈或截图。

安装步骤

要安装并运行此MCP服务器，请遵循以下步骤：

  1. 克隆仓库: 打开终端或命令行，克隆项目仓库。 
    git clone https://github.com/ceciliomichael/feedbackjs-mcp.git
cd feedbackjs-mcp
  2. 安装依赖: 进入项目目录，安装所需的依赖包，包括MCP SDK和Electron Forge。 
    npm install
  3. 构建应用: 使用Electron Forge构建桌面应用的可执行文件。这一步会创建'out'目录，其中包含特定操作系统的应用。 
    npm run make

服务器配置

该MCP服务器不是独立运行的应用，而是由支持MCP协议的LLM客户端（如Claude Desktop, Cursor等）按需启动和通信的后端服务。您需要在您的LLM客户端的配置中添加此MCP服务器的信息。典型的配置方式是指定一个服务器名称、启动服务器的命令及其参数。

以下是配置该服务器所需的关键信息（请根据您的LLM客户端的具体配置格式填写）：

  • 服务器名称 (Server Name): 您可以自定义一个名称，例如 'feedback-collector'。
  • 启动命令 (Command): 通常是 'node'，表示使用Node.js环境来执行服务器脚本。
  • 命令参数 (Args): 一个数组，包含传递给'node'命令的参数。第一个参数应为'mcp-server.js'文件的绝对路径。请确保使用'npm run make'构建后生成的'mcp-server.js'文件的正确路径。

当您的LLM客户端需要收集用户反馈时，它将根据您的配置启动此MCP服务器，并通过标准输入/输出来进行JSON-RPC通信，并进一步启动Electron桌面应用与用户互动。

基本使用方法

  1. 完成安装和构建。
  2. 在您的LLM客户端中配置Feedback Collector MCP服务器， 提供正确的启动命令（指向构建后的'mcp-server.js'脚本）。
  3. 在与LLM交互时，当LLM决定需要获取用户反馈时，它会调用此MCP服务器提供的工具。 该工具的名称是 'collect_feedback'。
  4. 调用工具时，LLM客户端可以提供参数， 例如 'prompt' (要在窗口中显示的提示信息), 'title' (窗口标题), 'time_format', 'timezone' 等。
  5. MCP服务器接收到调用请求后，将启动Electron桌面应用。 应用窗口将显示LLM提供的提示信息。
  6. 用户在桌面应用中输入文本反馈、上传图片， 并点击提交按钮。
  7. 桌面应用将用户输入的数据发送回MCP服务器， 服务器将数据处理并格式化为MCP响应，然后返回给LLM客户端。
  8. LLM客户端收到反馈后，可以继续进行后续处理。

注意：每次调用'collect_feedback'工具时，MCP服务器会启动一个新的Electron应用实例来处理该请求。

信息

分类

桌面与硬件

访问项目