mcp-feedback-enhanced 2.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,19 @@
1
+ # Python-generated files
2
+ __pycache__/
3
+ *.py[oc]
4
+ build/
5
+ dist/
6
+ wheels/
7
+ *.egg-info
8
+
9
+ # Virtual environments
10
+ .venv*/
11
+ venv*/
12
+
13
+ # Logs
14
+ *.log
15
+
16
+ #Others
17
+ .DS_Store
18
+
19
+ .cursor/rules/
@@ -0,0 +1 @@
1
+ 3.11
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Fábio Ferreira
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,299 @@
1
+ Metadata-Version: 2.4
2
+ Name: mcp-feedback-enhanced
3
+ Version: 2.0.0
4
+ Summary: Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual UI support (Qt GUI and Web UI) with intelligent environment detection.
5
+ Project-URL: Homepage, https://github.com/Minidoracat/mcp-feedback-enhanced
6
+ Project-URL: Repository, https://github.com/Minidoracat/mcp-feedback-enhanced
7
+ Project-URL: Issues, https://github.com/Minidoracat/mcp-feedback-enhanced/issues
8
+ Author-email: Minidoracat <minidora0702@gmail.com>
9
+ License-File: LICENSE
10
+ Keywords: ai,development,feedback,gui,interactive,mcp,web-ui
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
18
+ Classifier: Topic :: Software Development :: User Interfaces
19
+ Requires-Python: >=3.11
20
+ Requires-Dist: fastapi>=0.115.0
21
+ Requires-Dist: fastmcp>=2.0.0
22
+ Requires-Dist: jinja2>=3.1.0
23
+ Requires-Dist: psutil>=7.0.0
24
+ Requires-Dist: pyside6>=6.8.2.1
25
+ Requires-Dist: uvicorn>=0.30.0
26
+ Requires-Dist: websockets>=13.0.0
27
+ Provides-Extra: dev
28
+ Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
29
+ Requires-Dist: pytest>=7.0.0; extra == 'dev'
30
+ Description-Content-Type: text/markdown
31
+
32
+ # Interactive Feedback MCP(互動回饋 MCP)
33
+
34
+ **原作者:** [Fábio Ferreira](https://x.com/fabiomlferreira)
35
+ **分支版本:** [Minidoracat](https://github.com/Minidoracat)
36
+ **相關資源:** [dotcursorrules.com](https://dotcursorrules.com/) 提供更多 AI 開發增強工具
37
+
38
+ 這是一個簡單的 [MCP 伺服器](https://modelcontextprotocol.io/),用於在 AI 輔助開發工具(如 [Cursor](https://www.cursor.com))中實現人在回路(human-in-the-loop)的工作流程。該伺服器允許您執行命令、查看輸出並直接向 AI 提供文字回饋。同時支援 [Cline](https://cline.bot) 和 [Windsurf](https://windsurf.com)。
39
+
40
+ ## ✨ 新功能:Web UI 支援
41
+
42
+ **🌐 支援 SSH Remote 開發環境**
43
+ 此分支版本新增了 Web UI 功能,完美解決了 SSH remote 開發環境中無法使用 GUI 的問題:
44
+
45
+ - **自動環境檢測**:系統會自動檢測運行環境
46
+ - **本地環境**:使用原有的 Qt GUI 介面
47
+ - **SSH Remote 環境**:自動切換到現代化 Web UI
48
+ - **即時通訊**:基於 WebSocket 的即時命令輸出和回饋
49
+ - **深色主題**:提供現代化的深色主題界面
50
+
51
+ ## 🎯 為什麼使用這個工具?
52
+
53
+ 透過引導 AI 助手與用戶進行確認,而非進行推測性的高成本工具調用,此模組可以大幅減少平台(如 Cursor)上的付費請求次數。在某些情況下,它可以將多達 25 次工具調用合併為單次回饋導向的請求,節省資源並提升效能。
54
+
55
+ ## 📝 提示工程設定
56
+
57
+ 為了獲得最佳效果,請在您的 AI 助手中添加以下自訂提示(例如在 Cursor 的規則或提示中):
58
+
59
+ > 每當你想要詢問問題時,請務必調用 MCP `interactive_feedback`。
60
+ > 每當你即將完成用戶請求時,請調用 MCP `interactive_feedback` 而不是直接結束流程。
61
+ > 持續調用 MCP 直到用戶的回饋為空,然後才結束請求。
62
+
63
+ 這將確保您的 AI 助手在標記任務完成前使用此 MCP 伺服器請求用戶回饋。
64
+
65
+ ## 🔧 環境檢測與配置
66
+
67
+ 系統會自動檢測運行環境並選擇適當的介面:
68
+
69
+ ### Qt GUI(本地環境)
70
+ - 使用 Qt 的 `QSettings` 按專案基礎儲存配置
71
+ - 包含命令設定、自動執行選項、視窗幾何狀態等
72
+ - 設定通常儲存在平台特定位置(Windows 登錄檔、macOS plist 檔案、Linux 配置目錄)
73
+
74
+ ### Web UI(SSH Remote 環境)
75
+ - 基於 FastAPI 和 WebSocket 的現代化界面
76
+ - 支援即時命令執行和輸出顯示
77
+ - 自動瀏覽器啟動和會話管理
78
+ - 深色主題和響應式設計
79
+
80
+ ## 🚀 安裝說明
81
+
82
+ ### 系統需求
83
+ - Python 3.11 或更新版本
84
+ - [uv](https://github.com/astral-sh/uv) 套件管理器
85
+ - Windows: `pip install uv`
86
+ - Linux/Mac: `curl -LsSf https://astral.sh/uv/install.sh | sh`
87
+
88
+ ### 安裝步驟
89
+
90
+ 1. **取得程式碼**
91
+ ```bash
92
+ git clone https://github.com/Minidoracat/interactive-feedback-mcp.git
93
+ cd interactive-feedback-mcp
94
+ ```
95
+
96
+ 2. **安裝依賴項**
97
+ ```bash
98
+ uv sync
99
+ ```
100
+
101
+ 3. **測試安裝**
102
+ ```bash
103
+ # 基本功能測試
104
+ uv run python test_web_ui.py
105
+
106
+ # 持久化測試模式(可在瀏覽器中實際測試)
107
+ uv run python test_web_ui.py --persistent
108
+ ```
109
+
110
+ 4. **運行 MCP 伺服器**
111
+ ```bash
112
+ uv run server.py
113
+ ```
114
+
115
+ ## ⚙️ AI 助手配置
116
+
117
+ ### Cursor 配置
118
+
119
+ 在 Cursor 的設定中配置自訂 MCP 伺服器,或手動編輯 `mcp.json`:
120
+
121
+ ```json
122
+ {
123
+ "mcpServers": {
124
+ "interactive-feedback-mcp": {
125
+ "command": "uv",
126
+ "args": [
127
+ "--directory",
128
+ "G:/github/interactive-feedback-mcp",
129
+ "run",
130
+ "server.py"
131
+ ],
132
+ "timeout": 600,
133
+ "env": {
134
+ "FORCE_WEB": "true"
135
+ },
136
+ "autoApprove": [
137
+ "interactive_feedback"
138
+ ]
139
+ }
140
+ }
141
+ }
142
+ ```
143
+
144
+ **記得將路徑修改為您實際的專案目錄!**
145
+
146
+ ### Cline / Windsurf 配置
147
+
148
+ 類似的設定原則:在各工具的 MCP 設定中配置伺服器命令,使用 `interactive-feedback-mcp` 作為伺服器識別符。
149
+
150
+ ## 🧪 測試和開發
151
+
152
+ ### 測試 Web UI 功能
153
+ ```bash
154
+ # 快速功能測試
155
+ uv run python test_web_ui.py
156
+
157
+ # 互動式測試模式(持久化運行)
158
+ uv run python test_web_ui.py --persistent
159
+ ```
160
+
161
+ ### 開發模式
162
+ 使用 FastMCP 開發模式運行伺服器並開啟測試界面:
163
+ ```bash
164
+ uv run fastmcp dev server.py
165
+ ```
166
+
167
+ ## 🌟 功能特色
168
+
169
+ ### 🖥️ 雙介面支援
170
+ - **Qt GUI**:適用於本地開發環境
171
+ - **Web UI**:適用於 SSH remote 開發環境
172
+
173
+ ### 🔍 智慧環境檢測
174
+ - 自動檢測 SSH 連線環境變數
175
+ - 檢測 DISPLAY 設定(Linux)
176
+ - 檢測 VSCode Remote 開發環境
177
+ - 自動選擇最適合的介面
178
+
179
+ ### 💻 命令執行功能
180
+ - 即時命令執行和輸出顯示
181
+ - 支援命令中斷和程序樹終止
182
+ - 自動工作目錄設定
183
+ - 命令歷史記錄
184
+
185
+ ### 🎨 現代化介面
186
+ - 深色主題設計
187
+ - 響應式佈局(支援手機瀏覽器)
188
+ - WebSocket 即時通訊
189
+ - 載入動畫和視覺回饋
190
+
191
+ ## 📖 使用範例
192
+
193
+ ### 1. **MCP 配置範例**
194
+
195
+ 使用環境變數強制 Web UI:
196
+ ```json
197
+ {
198
+ "mcpServers": {
199
+ "interactive-feedback-mcp": {
200
+ "command": "uv",
201
+ "args": [
202
+ "--directory",
203
+ "path/interactive-feedback-mcp",
204
+ "run",
205
+ "server.py"
206
+ ],
207
+ "timeout": 600,
208
+ "env": {
209
+ "FORCE_WEB": "true"
210
+ },
211
+ "autoApprove": [
212
+ "interactive_feedback"
213
+ ]
214
+ }
215
+ }
216
+ }
217
+ ```
218
+
219
+ ### 2. **工具調用範例**
220
+
221
+ AI 助手會如此調用 `interactive_feedback` 工具:
222
+
223
+ ```xml
224
+ <use_mcp_tool>
225
+ <server_name>interactive-feedback-mcp</server_name>
226
+ <tool_name>interactive_feedback</tool_name>
227
+ <arguments>
228
+ {
229
+ "project_directory": "/path/to/your/project",
230
+ "summary": "我已經實現了您請求的更改並重構了主模組。"
231
+ }
232
+ </arguments>
233
+ </use_mcp_tool>
234
+ ```
235
+
236
+ ### 3. **環境變數控制範例**
237
+
238
+ **在 MCP 配置中設定**:
239
+ ```json
240
+ "env": {
241
+ "FORCE_WEB": "true" // 強制使用 Web UI
242
+ }
243
+ ```
244
+
245
+ **支援的環境變數值**:
246
+ - `"true"`, `"1"`, `"yes"`, `"on"` → 強制使用 Web UI
247
+ - `"false"`, `"0"`, `"no"`, `"off"` → 使用預設邏輯
248
+ - 未設定 → 根據環境自動檢測
249
+
250
+ **`INCLUDE_BASE64_DETAIL` 環境變數**:
251
+ - 設定為 `"true"`, `"1"`, `"yes"`, `"on"` 時在回饋中包含完整的圖片 Base64 數據
252
+ - 用於提高與不同 AI 助手的兼容性
253
+ - 預設為 `false`,只顯示 Base64 預覽信息
254
+
255
+ ## 🔄 工作流程
256
+
257
+ 1. **AI 助手調用** - AI 完成任務後調用 `interactive_feedback`
258
+ 2. **環境檢測** - 系統自動檢測運行環境
259
+ 3. **介面啟動** - 根據環境啟動 Qt GUI 或 Web UI
260
+ 4. **用戶互動** - 用戶可以執行命令、查看輸出、提供回饋
261
+ 5. **回饋傳遞** - 用戶回饋傳回給 AI 助手
262
+ 6. **流程繼續** - AI 根據回饋繼續或結束任務
263
+
264
+ ## 🆕 版本更新
265
+
266
+ ### v2.0 - Web UI 支援
267
+ - ✅ 新增 Web UI 介面支援 SSH remote 開發
268
+ - ✅ 自動環境檢測和介面選擇
269
+ - ✅ WebSocket 即時通訊
270
+ - ✅ 現代化深色主題
271
+ - ✅ 響應式設計支援
272
+ - ✅ 持久化測試模式
273
+
274
+ ### v1.0 - 基礎版本(原作者)
275
+ - ✅ Qt GUI 介面
276
+ - ✅ 命令執行功能
277
+ - ✅ MCP 協議支援
278
+ - ✅ 多平台支援
279
+
280
+ ## 🙏 致謝與聯繫
281
+
282
+ ### 原作者
283
+ **Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
284
+ 如果您覺得 Interactive Feedback MCP 有用,最好的支持方式是關注原作者的 X 帳號。
285
+
286
+ ### 分支維護者
287
+ 如有關於 Web UI 功能的問題或建議,歡迎在 [GitHub Issues](https://github.com/Minidoracat/interactive-feedback-mcp/issues) 中提出。
288
+
289
+ ### 相關資源
290
+ - [dotcursorrules.com](https://dotcursorrules.com/) - 更多 AI 輔助開發工作流程資源
291
+ - [Model Context Protocol](https://modelcontextprotocol.io/) - MCP 官方文件
292
+
293
+ ## 📄 授權條款
294
+
295
+ 本專案採用 MIT 授權條款。詳見 [LICENSE](LICENSE) 檔案。
296
+
297
+ ---
298
+
299
+ **🌟 歡迎 Star 此專案並分享給更多開發者!**
@@ -0,0 +1,268 @@
1
+ # Interactive Feedback MCP(互動回饋 MCP)
2
+
3
+ **原作者:** [Fábio Ferreira](https://x.com/fabiomlferreira)
4
+ **分支版本:** [Minidoracat](https://github.com/Minidoracat)
5
+ **相關資源:** [dotcursorrules.com](https://dotcursorrules.com/) 提供更多 AI 開發增強工具
6
+
7
+ 這是一個簡單的 [MCP 伺服器](https://modelcontextprotocol.io/),用於在 AI 輔助開發工具(如 [Cursor](https://www.cursor.com))中實現人在回路(human-in-the-loop)的工作流程。該伺服器允許您執行命令、查看輸出並直接向 AI 提供文字回饋。同時支援 [Cline](https://cline.bot) 和 [Windsurf](https://windsurf.com)。
8
+
9
+ ## ✨ 新功能:Web UI 支援
10
+
11
+ **🌐 支援 SSH Remote 開發環境**
12
+ 此分支版本新增了 Web UI 功能,完美解決了 SSH remote 開發環境中無法使用 GUI 的問題:
13
+
14
+ - **自動環境檢測**:系統會自動檢測運行環境
15
+ - **本地環境**:使用原有的 Qt GUI 介面
16
+ - **SSH Remote 環境**:自動切換到現代化 Web UI
17
+ - **即時通訊**:基於 WebSocket 的即時命令輸出和回饋
18
+ - **深色主題**:提供現代化的深色主題界面
19
+
20
+ ## 🎯 為什麼使用這個工具?
21
+
22
+ 透過引導 AI 助手與用戶進行確認,而非進行推測性的高成本工具調用,此模組可以大幅減少平台(如 Cursor)上的付費請求次數。在某些情況下,它可以將多達 25 次工具調用合併為單次回饋導向的請求,節省資源並提升效能。
23
+
24
+ ## 📝 提示工程設定
25
+
26
+ 為了獲得最佳效果,請在您的 AI 助手中添加以下自訂提示(例如在 Cursor 的規則或提示中):
27
+
28
+ > 每當你想要詢問問題時,請務必調用 MCP `interactive_feedback`。
29
+ > 每當你即將完成用戶請求時,請調用 MCP `interactive_feedback` 而不是直接結束流程。
30
+ > 持續調用 MCP 直到用戶的回饋為空,然後才結束請求。
31
+
32
+ 這將確保您的 AI 助手在標記任務完成前使用此 MCP 伺服器請求用戶回饋。
33
+
34
+ ## 🔧 環境檢測與配置
35
+
36
+ 系統會自動檢測運行環境並選擇適當的介面:
37
+
38
+ ### Qt GUI(本地環境)
39
+ - 使用 Qt 的 `QSettings` 按專案基礎儲存配置
40
+ - 包含命令設定、自動執行選項、視窗幾何狀態等
41
+ - 設定通常儲存在平台特定位置(Windows 登錄檔、macOS plist 檔案、Linux 配置目錄)
42
+
43
+ ### Web UI(SSH Remote 環境)
44
+ - 基於 FastAPI 和 WebSocket 的現代化界面
45
+ - 支援即時命令執行和輸出顯示
46
+ - 自動瀏覽器啟動和會話管理
47
+ - 深色主題和響應式設計
48
+
49
+ ## 🚀 安裝說明
50
+
51
+ ### 系統需求
52
+ - Python 3.11 或更新版本
53
+ - [uv](https://github.com/astral-sh/uv) 套件管理器
54
+ - Windows: `pip install uv`
55
+ - Linux/Mac: `curl -LsSf https://astral.sh/uv/install.sh | sh`
56
+
57
+ ### 安裝步驟
58
+
59
+ 1. **取得程式碼**
60
+ ```bash
61
+ git clone https://github.com/Minidoracat/interactive-feedback-mcp.git
62
+ cd interactive-feedback-mcp
63
+ ```
64
+
65
+ 2. **安裝依賴項**
66
+ ```bash
67
+ uv sync
68
+ ```
69
+
70
+ 3. **測試安裝**
71
+ ```bash
72
+ # 基本功能測試
73
+ uv run python test_web_ui.py
74
+
75
+ # 持久化測試模式(可在瀏覽器中實際測試)
76
+ uv run python test_web_ui.py --persistent
77
+ ```
78
+
79
+ 4. **運行 MCP 伺服器**
80
+ ```bash
81
+ uv run server.py
82
+ ```
83
+
84
+ ## ⚙️ AI 助手配置
85
+
86
+ ### Cursor 配置
87
+
88
+ 在 Cursor 的設定中配置自訂 MCP 伺服器,或手動編輯 `mcp.json`:
89
+
90
+ ```json
91
+ {
92
+ "mcpServers": {
93
+ "interactive-feedback-mcp": {
94
+ "command": "uv",
95
+ "args": [
96
+ "--directory",
97
+ "G:/github/interactive-feedback-mcp",
98
+ "run",
99
+ "server.py"
100
+ ],
101
+ "timeout": 600,
102
+ "env": {
103
+ "FORCE_WEB": "true"
104
+ },
105
+ "autoApprove": [
106
+ "interactive_feedback"
107
+ ]
108
+ }
109
+ }
110
+ }
111
+ ```
112
+
113
+ **記得將路徑修改為您實際的專案目錄!**
114
+
115
+ ### Cline / Windsurf 配置
116
+
117
+ 類似的設定原則:在各工具的 MCP 設定中配置伺服器命令,使用 `interactive-feedback-mcp` 作為伺服器識別符。
118
+
119
+ ## 🧪 測試和開發
120
+
121
+ ### 測試 Web UI 功能
122
+ ```bash
123
+ # 快速功能測試
124
+ uv run python test_web_ui.py
125
+
126
+ # 互動式測試模式(持久化運行)
127
+ uv run python test_web_ui.py --persistent
128
+ ```
129
+
130
+ ### 開發模式
131
+ 使用 FastMCP 開發模式運行伺服器並開啟測試界面:
132
+ ```bash
133
+ uv run fastmcp dev server.py
134
+ ```
135
+
136
+ ## 🌟 功能特色
137
+
138
+ ### 🖥️ 雙介面支援
139
+ - **Qt GUI**:適用於本地開發環境
140
+ - **Web UI**:適用於 SSH remote 開發環境
141
+
142
+ ### 🔍 智慧環境檢測
143
+ - 自動檢測 SSH 連線環境變數
144
+ - 檢測 DISPLAY 設定(Linux)
145
+ - 檢測 VSCode Remote 開發環境
146
+ - 自動選擇最適合的介面
147
+
148
+ ### 💻 命令執行功能
149
+ - 即時命令執行和輸出顯示
150
+ - 支援命令中斷和程序樹終止
151
+ - 自動工作目錄設定
152
+ - 命令歷史記錄
153
+
154
+ ### 🎨 現代化介面
155
+ - 深色主題設計
156
+ - 響應式佈局(支援手機瀏覽器)
157
+ - WebSocket 即時通訊
158
+ - 載入動畫和視覺回饋
159
+
160
+ ## 📖 使用範例
161
+
162
+ ### 1. **MCP 配置範例**
163
+
164
+ 使用環境變數強制 Web UI:
165
+ ```json
166
+ {
167
+ "mcpServers": {
168
+ "interactive-feedback-mcp": {
169
+ "command": "uv",
170
+ "args": [
171
+ "--directory",
172
+ "path/interactive-feedback-mcp",
173
+ "run",
174
+ "server.py"
175
+ ],
176
+ "timeout": 600,
177
+ "env": {
178
+ "FORCE_WEB": "true"
179
+ },
180
+ "autoApprove": [
181
+ "interactive_feedback"
182
+ ]
183
+ }
184
+ }
185
+ }
186
+ ```
187
+
188
+ ### 2. **工具調用範例**
189
+
190
+ AI 助手會如此調用 `interactive_feedback` 工具:
191
+
192
+ ```xml
193
+ <use_mcp_tool>
194
+ <server_name>interactive-feedback-mcp</server_name>
195
+ <tool_name>interactive_feedback</tool_name>
196
+ <arguments>
197
+ {
198
+ "project_directory": "/path/to/your/project",
199
+ "summary": "我已經實現了您請求的更改並重構了主模組。"
200
+ }
201
+ </arguments>
202
+ </use_mcp_tool>
203
+ ```
204
+
205
+ ### 3. **環境變數控制範例**
206
+
207
+ **在 MCP 配置中設定**:
208
+ ```json
209
+ "env": {
210
+ "FORCE_WEB": "true" // 強制使用 Web UI
211
+ }
212
+ ```
213
+
214
+ **支援的環境變數值**:
215
+ - `"true"`, `"1"`, `"yes"`, `"on"` → 強制使用 Web UI
216
+ - `"false"`, `"0"`, `"no"`, `"off"` → 使用預設邏輯
217
+ - 未設定 → 根據環境自動檢測
218
+
219
+ **`INCLUDE_BASE64_DETAIL` 環境變數**:
220
+ - 設定為 `"true"`, `"1"`, `"yes"`, `"on"` 時在回饋中包含完整的圖片 Base64 數據
221
+ - 用於提高與不同 AI 助手的兼容性
222
+ - 預設為 `false`,只顯示 Base64 預覽信息
223
+
224
+ ## 🔄 工作流程
225
+
226
+ 1. **AI 助手調用** - AI 完成任務後調用 `interactive_feedback`
227
+ 2. **環境檢測** - 系統自動檢測運行環境
228
+ 3. **介面啟動** - 根據環境啟動 Qt GUI 或 Web UI
229
+ 4. **用戶互動** - 用戶可以執行命令、查看輸出、提供回饋
230
+ 5. **回饋傳遞** - 用戶回饋傳回給 AI 助手
231
+ 6. **流程繼續** - AI 根據回饋繼續或結束任務
232
+
233
+ ## 🆕 版本更新
234
+
235
+ ### v2.0 - Web UI 支援
236
+ - ✅ 新增 Web UI 介面支援 SSH remote 開發
237
+ - ✅ 自動環境檢測和介面選擇
238
+ - ✅ WebSocket 即時通訊
239
+ - ✅ 現代化深色主題
240
+ - ✅ 響應式設計支援
241
+ - ✅ 持久化測試模式
242
+
243
+ ### v1.0 - 基礎版本(原作者)
244
+ - ✅ Qt GUI 介面
245
+ - ✅ 命令執行功能
246
+ - ✅ MCP 協議支援
247
+ - ✅ 多平台支援
248
+
249
+ ## 🙏 致謝與聯繫
250
+
251
+ ### 原作者
252
+ **Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
253
+ 如果您覺得 Interactive Feedback MCP 有用,最好的支持方式是關注原作者的 X 帳號。
254
+
255
+ ### 分支維護者
256
+ 如有關於 Web UI 功能的問題或建議,歡迎在 [GitHub Issues](https://github.com/Minidoracat/interactive-feedback-mcp/issues) 中提出。
257
+
258
+ ### 相關資源
259
+ - [dotcursorrules.com](https://dotcursorrules.com/) - 更多 AI 輔助開發工作流程資源
260
+ - [Model Context Protocol](https://modelcontextprotocol.io/) - MCP 官方文件
261
+
262
+ ## 📄 授權條款
263
+
264
+ 本專案採用 MIT 授權條款。詳見 [LICENSE](LICENSE) 檔案。
265
+
266
+ ---
267
+
268
+ **🌟 歡迎 Star 此專案並分享給更多開發者!**
@@ -0,0 +1,57 @@
1
+ [project]
2
+ name = "mcp-feedback-enhanced"
3
+ version = "2.0.0"
4
+ description = "Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual UI support (Qt GUI and Web UI) with intelligent environment detection."
5
+ readme = "README.md"
6
+ requires-python = ">=3.11"
7
+ authors = [
8
+ { name = "Minidoracat", email = "minidora0702@gmail.com" }
9
+ ]
10
+ keywords = ["mcp", "ai", "feedback", "gui", "web-ui", "interactive", "development"]
11
+ classifiers = [
12
+ "Development Status :: 4 - Beta",
13
+ "Intended Audience :: Developers",
14
+ "License :: OSI Approved :: MIT License",
15
+ "Programming Language :: Python :: 3",
16
+ "Programming Language :: Python :: 3.11",
17
+ "Programming Language :: Python :: 3.12",
18
+ "Topic :: Software Development :: Libraries :: Python Modules",
19
+ "Topic :: Software Development :: User Interfaces",
20
+ ]
21
+ dependencies = [
22
+ "fastmcp>=2.0.0",
23
+ "psutil>=7.0.0",
24
+ "pyside6>=6.8.2.1",
25
+ "fastapi>=0.115.0",
26
+ "uvicorn>=0.30.0",
27
+ "jinja2>=3.1.0",
28
+ "websockets>=13.0.0",
29
+ ]
30
+
31
+ [project.optional-dependencies]
32
+ dev = [
33
+ "pytest>=7.0.0",
34
+ "pytest-asyncio>=0.21.0",
35
+ ]
36
+
37
+ [project.urls]
38
+ Homepage = "https://github.com/Minidoracat/mcp-feedback-enhanced"
39
+ Repository = "https://github.com/Minidoracat/mcp-feedback-enhanced"
40
+ Issues = "https://github.com/Minidoracat/mcp-feedback-enhanced/issues"
41
+
42
+ [project.scripts]
43
+ mcp-feedback-enhanced = "mcp_feedback_enhanced.__main__:main"
44
+ interactive-feedback-mcp = "mcp_feedback_enhanced.__main__:main"
45
+
46
+ [build-system]
47
+ requires = ["hatchling"]
48
+ build-backend = "hatchling.build"
49
+
50
+ [tool.hatch.build.targets.wheel]
51
+ packages = ["src/mcp_feedback_enhanced"]
52
+
53
+ [tool.uv]
54
+ dev-dependencies = [
55
+ "pytest>=7.0.0",
56
+ "pytest-asyncio>=0.21.0",
57
+ ]