项目简介

User Feedback MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,专注于为 LLM 应用提供用户反馈功能。它通过集成到 Cline 和 Cursor 等工具中,允许开发者在 LLM 执行任务的关键节点暂停并征求用户意见,从而实现人机协同的工作流程,特别适用于需要复杂用户交互的桌面应用开发和测试。

主要功能点

  • 用户反馈收集: 提供 'user_feedback' 工具,允许 LLM 在执行任务过程中,弹出一个用户界面,向用户展示任务摘要并征求反馈意见。
  • 命令执行与日志记录: 允许用户配置并执行本地命令,并将命令执行过程中的日志记录下来,作为反馈的一部分提交给 LLM。
  • 灵活配置: 允许用户自定义运行命令,并支持自动执行命令和保存配置,方便快捷地集成到开发流程中。
  • 简单的安装和集成: 提供了详细的 Cline 集成步骤,方便用户快速安装和配置该 MCP 服务器。

安装步骤

  1. 安装 uv (可选但推荐): uv 是一个快速的 Python 包安装和运行工具,推荐使用 uv 运行此 MCP 服务器。
    • Windows: 'pip install uv'
    • Linux/Mac: 'curl -LsSf https://astral.sh/uv/install.sh | sh'
  2. 克隆仓库: 将 'user-feedback-mcp' 仓库克隆到本地,例如 'C:\MCP\user-feedback-mcp'。
    git clone https://github.com/mrexodia/user-feedback-mcp.git C:\MCP\user-feedback-mcp

服务器配置 (Cline)

要将此 MCP 服务器配置到 Cline 中,您需要编辑 Cline 的 MCP 服务器配置文件 'cline_mcp_settings.json',并添加以下配置信息。请注意将 'c:\MCP\user-feedback-mcp' 替换为您实际的仓库克隆路径。

{
  "mcpServers": {
    "github.com/mrexodia/user-feedback-mcp": {
      "command": "uv",  // 启动服务器的命令,如果未安装 uv,可以替换为 "python"
      "args": [
        "--directory",  // 指定工作目录参数
        "c:\\MCP\\user-feedback-mcp", //  MCP 服务器仓库的本地路径
        "run",         // uv 的 run 命令,用于运行 Python 脚本
        "server.py"    //  MCP 服务器的启动脚本
      ],
      "timeout": 3600   //  服务器连接超时时间,单位为秒
    }
  }
}

参数解释:

  • '"github.com/mrexodia/user-feedback-mcp"': 服务器名称,在 Cline 中用于标识和引用此服务器。
  • '"command": "uv"': 指定用于启动服务器的命令。这里使用 'uv',您也可以根据您的环境替换为 'python' 或其他 Python 运行命令。
  • '"args"': 启动命令的参数列表。
    • '"--directory"': 指定 MCP 服务器的工作目录为仓库根目录。
    • '"c:\MCP\user-feedback-mcp"': 请务必替换为 您克隆 'user-feedback-mcp' 仓库的实际本地路径。
    • '"run"': 使用 'uv run' 或 'python -m' 运行 Python 脚本。
    • '"server.py"': 指定要运行的服务器启动脚本为 'server.py'。
  • '"timeout": 3600': 设置 Cline 连接到此 MCP 服务器的超时时间为 3600 秒 (1 小时)。

基本使用方法

  1. 配置 Prompt: 为了让 Cline 在执行任务前调用用户反馈工具,您需要在自定义 Prompt 中添加以下指令:

    Before completing the task, use the user_feedback MCP tool to ask the user for feedback.
  2. 使用 'user_feedback' 工具: 当 Cline 执行到包含上述指令的 Prompt 时,会自动调用 'user_feedback' MCP 工具。您将在本地看到一个用户反馈界面弹出。

  3. 提供反馈: 在弹出的用户反馈界面中,您可以:

    • 查看执行的命令及其日志输出。
    • 在 "Feedback" 文本框中输入您的反馈意见。
    • 点击 "Submit Feedback" 按钮提交反馈。
  4. LLM 接收反馈: 提交反馈后,Cline 将接收到您的反馈内容和命令执行日志,并继续执行后续的 LLM 任务流程。

通过以上步骤,您就可以在 Cline 中使用 User Feedback MCP Server,实现人机协作的 LLM 工作流程。

信息

分类

AI与计算