Interact MCP

🚀 交互式反馈MCP

交互式反馈MCP由Pham Minh Nhat（nhatpm.lab）开发，邮箱：nhatpm.lab@gmail.com。此项目集成了模型上下文协议（MCP），可确保在关键节点与用户进行智能且交互式的反馈。

🚀 快速开始

若要在开发模式下运行带有测试Web界面的服务器，请使用以下命令：

uv run fastmcp dev server.py

执行此命令后，会打开一个Web界面，你可以与MCP工具进行交互测试。

✨ 主要特性

• 减少资源消耗：引导AI助手向用户确认信息，而非进行推测性的高成本工具调用，可大幅减少如Cursor等平台上的高级请求数量。在某些情况下，能将多达25次的工具调用整合为一次具备反馈感知的请求，节省资源并提升性能。
• 项目级配置存储：使用Qt的QSettings按项目存储配置，包括运行命令、是否在下次启动项目时自动执行命令、命令部分的可见状态、窗口几何形状和状态等。

📦 安装指南

暂未提供相关安装步骤。

💻 使用示例

基础用法

以下是AI助手调用interactive_feedback工具的示例：

<use_mcp_tool>
  <server_name>interactive-feedback-mcp</server_name>
  <tool_name>interactive_feedback</tool_name>
  <arguments>
    {
      "project_directory": "/path/to/your/project",
      "summary": "I've implemented the changes you requested and refactored the main module."
    }
  </arguments>
</use_mcp_tool>

高级用法

暂未提供相关高级用法示例。

📚 详细文档

提示工程

为获得最佳效果，你应在AI助手的自定义提示中添加以下内容，可将其添加到规则中或直接添加到提示里（例如在Cursor中）：

每当你想问问题时，始终调用MCP的interactive_feedback。 每当你即将完成用户请求时，调用MCP的interactive_feedback，而不是直接结束流程。 持续调用MCP，直到用户的反馈为空，然后结束请求。

这样能确保你的AI助手在将任务标记为完成之前，使用此MCP服务器向用户请求反馈。

配置

此MCP服务器使用Qt的QSettings按项目存储配置，具体包括：

• 要运行的命令。
• 该项目下次启动时是否自动执行命令（参见“下次运行时自动执行”复选框）。
• 命令部分的可见状态（显示/隐藏，切换时立即保存）。
• 窗口几何形状和状态（一般UI首选项）。

这些设置通常存储在特定平台的位置（例如，Windows上的注册表、macOS上的plist文件、Linux上~/.config或~/.local/share中的配置文件），组织名称为“NhatPM”，应用程序名称为“InteractiveFeedbackMCP”，每个项目目录有一个唯一的组。

UI中的“保存配置”按钮主要保存当前在命令输入字段中输入的命令，以及活动项目的“下次运行时自动执行”复选框的状态。命令部分的可见性在切换时自动保存。应用程序关闭时保存一般窗口大小和位置。

以下是配置示例：

{
  "mcpServers": {
    "interactive-feedback-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/nhatpm/Desktop/interactive-feedback-mcp",
        "run",
        "server.py"
      ],
      "timeout": 600,
      "autoApprove": [
        "interactive_feedback"
      ]
    }
  }
}

你在Cursor中配置时，可能会使用像interactive-feedback-mcp这样的服务器标识符。

针对Cline / Windsurf

类似的设置原则也适用。你需要在相应工具的MCP设置中配置服务器命令（例如，使用正确的--directory参数指向项目目录的uv run server.py），并使用interactive-feedback-mcp作为服务器标识符。

🔧 技术细节

此MCP服务器利用Qt的QSettings按项目存储配置，这些配置会存储在不同平台的特定位置。通过引导AI助手与用户交互，减少了不必要的工具调用，从而节省资源和提升性能。在配置方面，使用特定的JSON格式来定义服务器的命令、参数、超时时间等信息，方便在不同工具中进行配置。

📄 许可证

暂未提供相关许可证信息。

💡 使用建议

在配置服务器时，确保--directory参数正确指向项目目录，以避免出现找不到文件或命令执行失败的问题。同时，合理使用“下次运行时自动执行”选项，根据实际需求决定是否在下次启动项目时自动执行命令。

🔗 联系方式

如果你有任何问题、建议，或者想分享使用经验，欢迎在X上联系我们。