MCP/mcp-feedback-enhanced
1
0
Fork 0
mirror of https://github.com/Minidoracat/mcp-feedback-enhanced.git synced 2025-07-27 02:22:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

📝 更新 2.5.5 相關文檔

Browse Source
This commit is contained in:
Minidoracat 2025-06-21 22:41:52 +08:00
parent 5f951ddaba
commit 56f0938870
6 changed files with 282 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

73
README.md
View File

@ -8,7 +8,7 @@
## 🎯 Core Concept ## 🎯 Core Concept
This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, providing **Web UI and Desktop Application** dual interface options, perfectly adapting to local, **SSH Remote environments** (Cursor SSH Remote, VS Code Remote SSH), and **WSL (Windows Subsystem for Linux) environments**. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency. This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, providing **Web UI and Desktop Application** dual interface options, perfectly adapting to local, **SSH Remote environments**, and **WSL (Windows Subsystem for Linux) environments**. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency.
**🌐 Dual Interface Architecture Advantages:** **🌐 Dual Interface Architecture Advantages:**
- 🖥️ **Desktop Application**: Native cross-platform desktop experience, supporting Windows, macOS, Linux - 🖥️ **Desktop Application**: Native cross-platform desktop experience, supporting Windows, macOS, Linux
@ -92,9 +92,6 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee
```bash ```bash
# Install uv (if not already installed) # Install uv (if not already installed)
pip install uv pip install uv
# Quick test
uvx mcp-feedback-enhanced@latest test
``` ```
### 2. Configure MCP ### 2. Configure MCP
@ -170,10 +167,14 @@ follow mcp-feedback-enhanced instructions
| Variable | Purpose | Values | Default | | Variable | Purpose | Values | Default |
|----------|---------|--------|---------| |----------|---------|--------|---------|
| `MCP_DEBUG` | Debug mode | `true`/`false` | `false` | | `MCP_DEBUG` | Debug mode | `true`/`false` | `false` |
| `MCP_WEB_HOST` | Web UI host | IP address or hostname | `127.0.0.1` | | `MCP_WEB_HOST` | Web UI host binding | IP address or hostname | `127.0.0.1` |
| `MCP_WEB_PORT` | Web UI port | `1024-65535` | `8765` | | `MCP_WEB_PORT` | Web UI port | `1024-65535` | `8765` |
| `MCP_DESKTOP_MODE` | Desktop application mode | `true`/`false` | `false` | | `MCP_DESKTOP_MODE` | Desktop application mode | `true`/`false` | `false` |
**`MCP_WEB_HOST` Explanation**:
- `127.0.0.1` (default): Local access only, higher security
- `0.0.0.0`: Allow remote access, suitable for SSH remote development environments
### Testing Options ### Testing Options
```bash ```bash
# Version check # Version check
@ -230,23 +231,52 @@ make quick-check # Quick check and auto-f
## 🆕 Version History ## 🆕 Version History
📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.md](RELEASE_NOTES/CHANGELOG.md) 📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md)
### Latest Version Highlights (v2.5.0) ### Latest Version Highlights (v2.5.5)
- 🖥️ **Desktop Application**: Brand new cross-platform desktop application supporting Windows, macOS, Linux - 🌐 **SSH Remote Development Support**: Added `MCP_WEB_HOST` environment variable, completely solving SSH remote development access issues
- 📋 **AI Work Summary Markdown Display**: Support for Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats - 🍎 **Enhanced macOS Compilation Support**: Added PyO3 compilation configuration, supporting Intel and Apple Silicon architectures
- ⚡ **Significant Performance Enhancement**: Introduced debounce/throttle mechanisms to reduce unnecessary rendering and network requests - 📝 **Tool Documentation Optimization**: Moved LLM instructions to tool docstring, improving token efficiency
- 📊 **Session History Storage Improvement**: Migrated from localStorage to server-side local file storage - 🖥️ **Desktop Application MCP Protocol Fix**: Fixed MCP protocol communication pollution issues in desktop mode
- 🌐 **Network Connection Stability**: Improved WebSocket reconnection mechanism with network status detection - 📦 **Packaging Process Fix**: Fixed multi-platform desktop application packaging and publishing issues
- 🎨 **UI Rendering Optimization**: Optimized rendering performance for session management, statistics, and status indicators - 🔧 **Release Process Optimization**: Improved stability of automated release workflows
- 🛠️ **Build Process Optimization**: Added Makefile desktop application build commands and development tools - 📊 **AI Work Summary Markdown Enhancement**: Improved Markdown rendering effects and compatibility
- 📚 **Documentation Enhancement**: Added desktop application build guide and workflow documentation - 🔄 **Session History Process Optimization**: Improved session saving and management mechanisms
## 🐛 Common Issues ## 🐛 Common Issues
### 🌐 SSH Remote Environment Issues ### 🌐 SSH Remote Environment Issues
**Q: Browser cannot launch in SSH Remote environment** **Q: Browser cannot launch or access in SSH Remote environment**
A: This is normal. SSH Remote environments have no graphical interface, requiring manual opening in local browser. For detailed solutions, refer to: [SSH Remote Environment Usage Guide](docs/en/ssh-remote/browser-launch-issues.md) A: Two solutions available:
**Solution 1: Environment Variable Setting (v2.5.5 Recommended)**
Set `"MCP_WEB_HOST": "0.0.0.0"` in MCP configuration to allow remote access:
```json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_WEB_HOST": "0.0.0.0",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"]
}
}
}
```
Then open in local browser: `http://[remote-host-IP]:8765`
**Solution 2: SSH Port Forwarding (Traditional Method)**
1. Use default configuration (`MCP_WEB_HOST`: `127.0.0.1`)
2. Set up SSH port forwarding:
- **VS Code Remote SSH**: Press `Ctrl+Shift+P` → "Forward a Port" → Enter `8765`
- **Cursor SSH Remote**: Manually add port forwarding rule (port 8765)
3. Open in local browser: `http://localhost:8765`
For detailed solutions, refer to: [SSH Remote Environment Usage Guide](docs/en/ssh-remote/browser-launch-issues.md)
**Q: Why am I not receiving new MCP feedback?** **Q: Why am I not receiving new MCP feedback?**
A: Likely a WebSocket connection issue. **Solution**: Directly refresh the browser page. A: Likely a WebSocket connection issue. **Solution**: Directly refresh the browser page.
@ -340,6 +370,15 @@ If you find it useful, please:
**penn201500** - [GitHub @penn201500](https://github.com/penn201500) **penn201500** - [GitHub @penn201500](https://github.com/penn201500)
- 🎯 Auto-focus input box feature ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39)) - 🎯 Auto-focus input box feature ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39))
**leo108** - [GitHub @leo108](https://github.com/leo108)
- 🌐 SSH Remote Development Support (`MCP_WEB_HOST` environment variable) ([PR #113](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/113))
**Alsan** - [GitHub @Alsan](https://github.com/Alsan)
- 🍎 macOS PyO3 Compilation Configuration Support ([PR #93](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/93))
**fireinice** - [GitHub @fireinice](https://github.com/fireinice)
- 📝 Tool Documentation Optimization (LLM instructions moved to docstring) ([PR #105](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/105))
### Community Support ### Community Support
- **Discord:** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67) - **Discord:** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67)
- **Issues:** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) - **Issues:** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)

71
README.zh-CN.md
View File

@ -8,7 +8,7 @@
## 🎯 核心概念 ## 🎯 核心概念
这是一个 [MCP 服务器](https://modelcontextprotocol.io/)，建立**反馈导向的开发工作流程**，提供**Web UI 和桌面应用程序**双重选择，完美适配本地、**SSH Remote 环境**（Cursor SSH Remote、VS Code Remote SSH）与 **WSL (Windows Subsystem for Linux) 环境**。通过引导 AI 与用户确认而非进行推测性操作，可将多次工具调用合并为单次反馈导向请求，大幅节省平台成本并提升开发效率。 这是一个 [MCP 服务器](https://modelcontextprotocol.io/)，建立**反馈导向的开发工作流程**，提供**Web UI 和桌面应用程序**双重选择，完美适配本地、**SSH 远程开发环境**与 **WSL (Windows Subsystem for Linux) 环境**。通过引导 AI 与用户确认而非进行推测性操作，可将多次工具调用合并为单次反馈导向请求，大幅节省平台成本并提升开发效率。
**🌐 双重界面架构优势：** **🌐 双重界面架构优势：**
- 🖥️ **桌面应用程序**：原生跨平台桌面体验，支持 Windows、macOS、Linux - 🖥️ **桌面应用程序**：原生跨平台桌面体验，支持 Windows、macOS、Linux
@ -92,9 +92,6 @@
```bash ```bash
# 安装 uv（如果尚未安装） # 安装 uv（如果尚未安装）
pip install uv pip install uv
# 快速测试
uvx mcp-feedback-enhanced@latest test
``` ```
### 2. 配置 MCP ### 2. 配置 MCP
@ -170,10 +167,14 @@ uvx mcp-feedback-enhanced@latest test
| 变量 | 用途 | 值 | 默认 | | 变量 | 用途 | 值 | 默认 |
|------|------|-----|------| |------|------|-----|------|
| `MCP_DEBUG` | 调试模式 | `true`/`false` | `false` | | `MCP_DEBUG` | 调试模式 | `true`/`false` | `false` |
| `MCP_WEB_HOST` | Web UI 主机 | IP 地址或主机名 | `127.0.0.1` | | `MCP_WEB_HOST` | Web UI 主机绑定 | IP 地址或主机名 | `127.0.0.1` |
| `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` | | `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` |
| `MCP_DESKTOP_MODE` | 桌面应用程序模式 | `true`/`false` | `false` | | `MCP_DESKTOP_MODE` | 桌面应用程序模式 | `true`/`false` | `false` |
**`MCP_WEB_HOST` 说明**：
- `127.0.0.1`（默认）：仅本地访问，安全性较高
- `0.0.0.0`：允许远程访问，适用于 SSH 远程开发环境
### 测试选项 ### 测试选项
```bash ```bash
# 版本查询 # 版本查询
@ -232,21 +233,50 @@ make quick-check # 快速检查并自动
📋 **完整版本更新记录：** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md) 📋 **完整版本更新记录：** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md)
### 最新版本亮点（v2.5.0） ### 最新版本亮点（v2.5.5）
- 🖥️ **桌面应用程序**: 全新跨平台桌面应用，支持 Windows、macOS、Linux - 🌐 **SSH 远程开发支持**: 新增 `MCP_WEB_HOST` 环境变量，彻底解决 SSH 远程开发访问问题
- 📋 **AI 工作摘要 Markdown 显示**: 支持 Markdown 语法渲染，包含标题、粗体、代码区块、列表、链接等格式 - 🍎 **macOS 编译支持增强**: 新增 PyO3 编译配置，支持 Intel 和 Apple Silicon 架构
- ⚡ **性能大幅提升**: 引入防抖/节流机制，减少不必要的渲染和网络请求 - 📝 **工具文档优化**: 将 LLM 指令移至工具 docstring，提升 token 效率
- 📊 **会话历史存储改进**: 从 localStorage 改为服务器端本地文件存储 - 🖥️ **桌面应用 MCP 协议修复**: 修正桌面模式下 MCP 协议通信污染问题
- 🌐 **网络连接稳定性**: 改进 WebSocket 重连机制，支持网络状态检测 - 📦 **打包流程修复**: 修正多平台桌面应用打包和发布问题
- 🎨 **UI 渲染优化**: 优化会话管理、统计信息、状态指示器的渲染性能 - 🔧 **发布流程优化**: 改进自动化发布工作流程的稳定性
- 🛠️ **构建流程优化**: 新增 Makefile 桌面应用构建命令和开发工具 - 📊 **AI 工作摘要 Markdown 增强**: 改进 Markdown 渲染效果和兼容性
- 📚 **文档完善**: 新增桌面应用构建指南和工作流程说明 - 🔄 **会话历史流程优化**: 改进会话保存和管理机制
## 🐛 常见问题 ## 🐛 常见问题
### 🌐 SSH Remote 环境问题 ### 🌐 SSH Remote 环境问题
**Q: SSH Remote 环境下浏览器无法启动** **Q: SSH Remote 环境下浏览器无法启动或无法访问**
A: 这是正常现象。SSH Remote 环境没有图形界面，需要手动在本地浏览器打开。详细解决方案请参考：[SSH Remote 环境使用指南](docs/zh-CN/ssh-remote/browser-launch-issues.md) A: 提供两种解决方案：
**方案一：环境变量设置（v2.5.5 推荐）**
在 MCP 配置中设置 `"MCP_WEB_HOST": "0.0.0.0"` 允许远程访问：
```json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_WEB_HOST": "0.0.0.0",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"]
}
}
}
```
然后在本地浏览器打开：`http://[远程主机IP]:8765`
**方案二：SSH 端口转发（传统方法）**
1. 使用默认配置（`MCP_WEB_HOST`: `127.0.0.1`）
2. 设置 SSH 端口转发：
- **VS Code Remote SSH**: 按 `Ctrl+Shift+P` → "Forward a Port" → 输入 `8765`
- **Cursor SSH Remote**: 手动添加端口转发规则（端口 8765）
3. 在本地浏览器打开：`http://localhost:8765`
详细解决方案请参考：[SSH Remote 环境使用指南](docs/zh-CN/ssh-remote/browser-launch-issues.md)
**Q: 为什么没有接收到 MCP 新的反馈？** **Q: 为什么没有接收到 MCP 新的反馈？**
A: 可能是 WebSocket 连接问题。**解决方法**：直接重新刷新浏览器页面。 A: 可能是 WebSocket 连接问题。**解决方法**：直接重新刷新浏览器页面。
@ -340,6 +370,15 @@ A: 各种 AI 模型（包括 Gemini Pro 2.5、Claude 等）在图片解析上可
**penn201500** - [GitHub @penn201500](https://github.com/penn201500) **penn201500** - [GitHub @penn201500](https://github.com/penn201500)
- 🎯 自动聚焦输入框功能 ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39)) - 🎯 自动聚焦输入框功能 ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39))
**leo108** - [GitHub @leo108](https://github.com/leo108)
- 🌐 SSH 远程开发支持 (`MCP_WEB_HOST` 环境变量) ([PR #113](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/113))
**Alsan** - [GitHub @Alsan](https://github.com/Alsan)
- 🍎 macOS PyO3 编译配置支持 ([PR #93](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/93))
**fireinice** - [GitHub @fireinice](https://github.com/fireinice)
- 📝 工具文档优化 (LLM 指令移至 docstring) ([PR #105](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/105))
### 社群支援 ### 社群支援
- **Discord：** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67) - **Discord：** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67)
- **Issues：** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) - **Issues：** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)

69
README.zh-TW.md
View File

@ -92,9 +92,6 @@
```bash ```bash
# 安裝 uv（如果尚未安裝） # 安裝 uv（如果尚未安裝）
pip install uv pip install uv
# 快速測試
uvx mcp-feedback-enhanced@latest test
``` ```
### 2. 配置 MCP ### 2. 配置 MCP
@ -170,10 +167,14 @@ uvx mcp-feedback-enhanced@latest test
| 變數 | 用途 | 值 | 默認 | | 變數 | 用途 | 值 | 默認 |
|------|------|-----|------| |------|------|-----|------|
| `MCP_DEBUG` | 調試模式 | `true`/`false` | `false` | | `MCP_DEBUG` | 調試模式 | `true`/`false` | `false` |
| `MCP_WEB_HOST` | Web UI 主機 | IP 地址或主機名 | `127.0.0.1` | | `MCP_WEB_HOST` | Web UI 主機綁定 | IP 地址或主機名 | `127.0.0.1` |
| `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` | | `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` |
| `MCP_DESKTOP_MODE` | 桌面應用程式模式 | `true`/`false` | `false` | | `MCP_DESKTOP_MODE` | 桌面應用程式模式 | `true`/`false` | `false` |
**`MCP_WEB_HOST` 說明**：
- `127.0.0.1`（預設）：僅本地存取，安全性較高
- `0.0.0.0`：允許遠端存取，適用於 SSH 遠端開發環境
### 測試選項 ### 測試選項
```bash ```bash
# 版本查詢 # 版本查詢
@ -233,21 +234,50 @@ make quick-check # 快速檢查並自動
📋 **完整版本更新記錄：** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md) 📋 **完整版本更新記錄：** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md)
### 最新版本亮點（v2.5.0） ### 最新版本亮點（v2.5.5）
- 🖥️ **桌面應用程式**: 全新跨平台桌面應用，支援 Windows、macOS、Linux - 🌐 **SSH 遠端開發支援**: 新增 `MCP_WEB_HOST` 環境變數，徹底解決 SSH 遠端開發存取問題
- 📋 **AI 工作摘要 Markdown 顯示**: 支援 Markdown 語法渲染，包含標題、粗體、程式碼區塊、列表、連結等格式 - 🍎 **macOS 編譯支援增強**: 新增 PyO3 編譯配置，支援 Intel 和 Apple Silicon 架構
- ⚡ **效能大幅提升**: 引入防抖/節流機制，減少不必要的渲染和網路請求 - 📝 **工具文檔優化**: 將 LLM 指令移至工具 docstring，提升 token 效率
- 📊 **會話歷史存儲改進**: 從 localStorage 改為伺服器端本地檔案存儲 - <EFBFBD>️ **桌面應用 MCP 協議修復**: 修正桌面模式下 MCP 協議通訊污染問題
- 🌐 **網路連接穩定性**: 改進 WebSocket 重連機制，支援網路狀態檢測 - 📦 **打包流程修復**: 修正多平台桌面應用打包和發布問題
- 🎨 **UI 渲染優化**: 優化會話管理、統計資訊、狀態指示器的渲染效能 - 🔧 **發布流程優化**: 改進自動化發布工作流程的穩定性
- 🛠️ **構建流程優化**: 新增 Makefile 桌面應用構建命令和開發工具 - <EFBFBD> **AI 工作摘要 Markdown 增強**: 改進 Markdown 渲染效果和相容性
- 📚 **文檔完善**: 新增桌面應用構建指南和工作流程說明 - <EFBFBD> **會話歷史流程優化**: 改進會話保存和管理機制
## 🐛 常見問題 ## 🐛 常見問題
### 🌐 SSH Remote 環境問題 ### 🌐 SSH Remote 環境問題
**Q: SSH Remote 環境下瀏覽器無法啟動** **Q: SSH Remote 環境下瀏覽器無法啟動或無法存取**
A: 這是正常現象。SSH Remote 環境沒有圖形界面，需要手動在本地瀏覽器開啟。詳細解決方案請參考：[SSH Remote 環境使用指南](docs/zh-TW/ssh-remote/browser-launch-issues.md) A: 提供兩種解決方案：
**方案一：環境變數設定（v2.5.5 推薦）**
在 MCP 配置中設定 `"MCP_WEB_HOST": "0.0.0.0"` 允許遠端存取：
```json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_WEB_HOST": "0.0.0.0",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"]
}
}
}
```
然後在本地瀏覽器開啟：`http://[遠端主機IP]:8765`
**方案二：SSH 端口轉發（傳統方法）**
1. 使用預設配置（`MCP_WEB_HOST`: `127.0.0.1`）
2. 設定 SSH 端口轉發：
- **VS Code Remote SSH**: 按 `Ctrl+Shift+P` → "Forward a Port" → 輸入 `8765`
- **Cursor SSH Remote**: 手動添加端口轉發規則（端口 8765）
3. 在本地瀏覽器開啟：`http://localhost:8765`
詳細解決方案請參考：[SSH Remote 環境使用指南](docs/zh-TW/ssh-remote/browser-launch-issues.md)
**Q: 為什麼沒有接收到 MCP 新的反饋？** **Q: 為什麼沒有接收到 MCP 新的反饋？**
A: 可能是 WebSocket 連接問題。**解決方法**：直接重新整理瀏覽器頁面。 A: 可能是 WebSocket 連接問題。**解決方法**：直接重新整理瀏覽器頁面。
@ -341,6 +371,15 @@ A: 各種 AI 模型（包括 Gemini Pro 2.5、Claude 等）在圖片解析上可
**penn201500** - [GitHub @penn201500](https://github.com/penn201500) **penn201500** - [GitHub @penn201500](https://github.com/penn201500)
- 🎯 自動聚焦輸入框功能 ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39)) - 🎯 自動聚焦輸入框功能 ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39))
**leo108** - [GitHub @leo108](https://github.com/leo108)
- 🌐 SSH 遠端開發支援 (`MCP_WEB_HOST` 環境變數) ([PR #113](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/113))
**Alsan** - [GitHub @Alsan](https://github.com/Alsan)
- 🍎 macOS PyO3 編譯配置支援 ([PR #93](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/93))
**fireinice** - [GitHub @fireinice](https://github.com/fireinice)
- 📝 工具文檔優化 (LLM 指令移至 docstring) ([PR #105](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/105))
### 社群支援 ### 社群支援
- **Discord：** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67) - **Discord：** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67)
- **Issues：** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) - **Issues：** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)

39
RELEASE_NOTES/CHANGELOG.en.md
View File

@ -2,6 +2,45 @@
This document records all version updates for **MCP Feedback Enhanced**. This document records all version updates for **MCP Feedback Enhanced**.
## [v2.5.5] - 2025-06-21 - SSH Remote Development Support & Stability Enhancement
### 🌟 Version Highlights
Added SSH remote development environment support, resolving Web UI access issues in remote development scenarios. Enhanced macOS compilation support and desktop application stability for improved developer experience.
### ✨ New Features
- 🌐 **SSH Remote Development Support**: Added `MCP_WEB_HOST` environment variable for configuring web server host binding
- Defaults to `127.0.0.1` for security
- Can be set to `0.0.0.0` to allow remote access
- Resolves access issues in remote development environments like Cursor SSH Remote
- 🍎 **Enhanced macOS Compilation Support**: Added `.cargo/config.toml` configuration file
- Supports Intel (x86_64) and Apple Silicon (aarch64) architectures
- Resolves macOS PyO3 undefined dynamic_lookup compilation issues
- Follows PyO3 official recommended best practices
### 🚀 Improvements
- 📝 **Tool Documentation Optimization**: Moved LLM instructions to tool docstring for improved token efficiency
- 🎨 **Simplified User Configuration**: Removed complex Cursor rules configuration
- 📊 **Enhanced AI Work Summary Markdown**: Improved Markdown rendering effects and compatibility
- 🔄 **Session History Process Optimization**: Enhanced session saving and management mechanisms
### 🐛 Bug Fixes
- 🖥️ **Desktop Application MCP Protocol Fix**: Fixed MCP protocol communication pollution issues in desktop mode
- 📦 **Packaging Process Fix**: Fixed multi-platform desktop application packaging and publishing issues
- 🔧 **Release Process Optimization**: Improved stability of automated release workflows
- 🔥 **Removed ESC Shortcut**: Removed ESC shortcut functionality that could cause accidental closure
### 🛠️ Technical Improvements
- 🏗️ **Enhanced Build System**: Improved cross-platform compilation configuration and dependency management
- 📚 **Documentation Automation**: Enhanced tool self-documentation following FastMCP best practices
- 🔍 **Enhanced Debugging Features**: Added more detailed debugging information and error handling
### 📋 Usage Instructions
- **SSH Remote Development**: Set `"MCP_WEB_HOST": "0.0.0.0"` in MCP configuration to allow remote access
- **Local Development**: Keep default `"MCP_WEB_HOST": "127.0.0.1"` for security
- **macOS Development**: New compilation configuration will take effect automatically without additional setup
---
## [v2.5.0] - 2025-06-15 - Desktop Application & Performance Optimization ## [v2.5.0] - 2025-06-15 - Desktop Application & Performance Optimization
### 🌟 Version Highlights ### 🌟 Version Highlights

39
RELEASE_NOTES/CHANGELOG.zh-CN.md
View File

@ -2,6 +2,45 @@
本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。 本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。
## [v2.5.5] - 2025-06-21 - SSH 远程开发支持与稳定性增强
### 🌟 版本亮点
新增 SSH 远程开发环境支持，解决远程开发时无法访问 Web UI 的问题。同时改进 macOS 编译支持和桌面应用稳定性，提升开发者体验。
### ✨ 新功能
- 🌐 **SSH 远程开发支持**: 新增 `MCP_WEB_HOST` 环境变量，支持设置 Web 服务器主机绑定
- 默认为 `127.0.0.1` 确保安全性
- 可设置为 `0.0.0.0` 允许远程访问
- 解决 Cursor SSH Remote 等远程开发环境的访问问题
- 🍎 **macOS 编译支持增强**: 新增 `.cargo/config.toml` 配置文件
- 支持 Intel (x86_64) 和 Apple Silicon (aarch64) 架构
- 解决 macOS 上 PyO3 undefined dynamic_lookup 编译问题
- 遵循 PyO3 官方推荐的最佳实践
### 🚀 改进功能
- 📝 **工具文档优化**: 将 LLM 指令移至工具 docstring，提升 token 效率
- 🎨 **用户配置简化**: 移除复杂的 Cursor 规则配置
- 📊 **AI 工作摘要 Markdown 增强**: 改进 Markdown 渲染效果和兼容性
- 🔄 **会话历史流程优化**: 改进会话保存和管理机制
### 🐛 问题修复
- 🖥️ **桌面应用 MCP 协议修复**: 修正桌面模式下 MCP 协议通信污染问题
- 📦 **打包流程修复**: 修正多平台桌面应用打包和发布问题
- 🔧 **发布流程优化**: 改进自动化发布工作流程的稳定性
- 🔥 **移除 ESC 快捷键**: 移除可能造成意外关闭的 ESC 快捷键功能
### 🛠️ 技术改进
- 🏗️ **构建系统增强**: 改进跨平台编译配置和依赖管理
- 📚 **文档自动化**: 改进工具自我文档化，遵循 FastMCP 最佳实践
- 🔍 **调试功能增强**: 新增更详细的调试信息和错误处理
### 📋 使用说明
- **SSH 远程开发**: 在 MCP 配置中设置 `"MCP_WEB_HOST": "0.0.0.0"` 允许远程访问
- **本地开发**: 保持默认 `"MCP_WEB_HOST": "127.0.0.1"` 确保安全性
- **macOS 开发**: 新的编译配置将自动生效，无需额外设置
---
## [v2.5.0] - 2025-06-15 - 桌面应用程序与性能优化 ## [v2.5.0] - 2025-06-15 - 桌面应用程序与性能优化
### 🌟 版本亮点 ### 🌟 版本亮点

39
RELEASE_NOTES/CHANGELOG.zh-TW.md
View File

@ -2,6 +2,45 @@
本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。 本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。
## [v2.5.5] - 2025-06-21 - SSH 遠端開發支援與穩定性增強
### 🌟 版本亮點
新增 SSH 遠端開發環境支援，解決遠端開發時無法存取 Web UI 的問題。同時改進 macOS 編譯支援和桌面應用穩定性，提升開發者體驗。
### ✨ 新功能
- 🌐 **SSH 遠端開發支援**: 新增 `MCP_WEB_HOST` 環境變數，支援設定 Web 伺服器主機綁定
- 預設為 `127.0.0.1` 確保安全性
- 可設定為 `0.0.0.0` 允許遠端存取
- 解決 Cursor SSH Remote 等遠端開發環境的存取問題
- 🍎 **macOS 編譯支援增強**: 新增 `.cargo/config.toml` 配置檔案
- 支援 Intel (x86_64) 和 Apple Silicon (aarch64) 架構
- 解決 macOS 上 PyO3 undefined dynamic_lookup 編譯問題
- 遵循 PyO3 官方推薦的最佳實踐
### 🚀 改進功能
- 📝 **工具文檔優化**: 將 LLM 指令移至工具 docstring，提升 token 效率
- 🎨 **使用者配置簡化**: 移除複雜的 Cursor 規則配置
- 📊 **AI 工作摘要 Markdown 增強**: 改進 Markdown 渲染效果和相容性
- 🔄 **會話歷史流程優化**: 改進會話保存和管理機制
### 🐛 問題修復
- 🖥️ **桌面應用 MCP 協議修復**: 修正桌面模式下 MCP 協議通訊污染問題
- 📦 **打包流程修復**: 修正多平台桌面應用打包和發布問題
- 🔧 **發布流程優化**: 改進自動化發布工作流程的穩定性
- 🔥 **移除 ESC 快捷鍵**: 移除可能造成意外關閉的 ESC 快捷鍵功能
### 🛠️ 技術改進
- 🏗️ **構建系統增強**: 改進跨平台編譯配置和相依性管理
- 📚 **文檔自動化**: 改進工具自我文檔化，遵循 FastMCP 最佳實踐
- 🔍 **調試功能增強**: 新增更詳細的調試訊息和錯誤處理
### 📋 使用說明
- **SSH 遠端開發**: 在 MCP 配置中設定 `"MCP_WEB_HOST": "0.0.0.0"` 允許遠端存取
- **本地開發**: 保持預設 `"MCP_WEB_HOST": "127.0.0.1"` 確保安全性
- **macOS 開發**: 新的編譯配置將自動生效，無需額外設定
---
## [v2.5.0] - 2025-06-15 - 桌面應用程式與效能優化 ## [v2.5.0] - 2025-06-15 - 桌面應用程式與效能優化
### 🌟 版本亮點 ### 🌟 版本亮點