Back to MCP directory
publicPublicdnsLocal runtime

user-feedback-mcp

一个用于实现人机交互工作流程的MCP服务器,适用于Cline和Cursor等工具。

article

README

🚀 用户反馈 MCP 服务器

这是一个简单的 MCP Server,主要用于在工具(如 ClineCursor)中启用人机协作工作流。在桌面应用程序开发中,若需要进行复杂的用户交互测试,该服务器会发挥出特别大的作用。

显示反馈界面的截图

🚀 快速开始

✨ 提示工程

为了达到最佳效果,建议在自定义提示中添加以下内容:

在完成任务之前,使用用户反馈 MCP 工具向用户请求反馈。

这样做能确保 Cline 使用此 MCP 服务器,在标记任务为完成之前向用户请求反馈。

📦 .user-feedback.json

当点击 保存配置 时,会在项目目录中创建一个 .user-feedback.json 文件,其内容示例如下:

{
  "command": "npm run dev",
  "execute_automatically": false
}

此配置会在启动时加载。若 execute_automatically 启用,命令将自动执行(无需手动点击 运行)。对于多步骤命令,推荐使用 Task

📦 安装(Cline)

要在 Cline 中安装 MCP 服务器,请按照以下步骤操作(见截图):

显示安装步骤的截图

  1. 全球安装 uv
    • Windows: pip install uv
    • Linux/Mac: curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 克隆此仓库,例如克隆到 C:\MCP\user-feedback-mcp
  3. 导航到 Cline 的 MCP 服务器 配置(见截图)。
  4. 点击 已安装 标签。
  5. 点击 配置 MCP 服务器,这将打开 cline_mcp_settings.json
  6. mcpServers 中添加以下内容:
{
  "mcpServers": {
    "github.com/mrexodia/user-feedback-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "c:\\MCP\\user-feedback-mcp",
        "run",
        "server.py"
      ],
      "timeout": 600,
      "autoApprove": [
        "user_feedback"
      ]
    }
  }
}

💻 使用示例

基础用法

uv run fastmcp dev server.py

执行上述命令后,会打开一个网络界面,访问地址为 http://localhost:5173,您可以通过该界面与 MCP 工具交互进行测试。

高级用法

<use_mcp_tool>
<server_name>github.com/mrexodia/user-feedback-mcp</server_name>
<tool_name>user_feedback</tool_name>
<arguments>
{
  "project_directory": "C:/MCP/user-feedback-mcp",
  "summary": "我已经实施了您要求的更改。"
}
</arguments>
</use_mcp_tool>

此代码展示了可用工具的使用方式。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client