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上聯繫我們。