Metadata-Version: 2.4
Name: mcp-feedback-ultra
Version: 2.8.0
Summary: MCP Feedback Ultra - Interactive feedback server for AI-assisted development with dual interface support (Web UI and Desktop Application)
Project-URL: Homepage, https://github.com/YangHang0210/mcp-feedback-ultra
Project-URL: Repository, https://github.com/YangHang0210/mcp-feedback-ultra
Project-URL: Issues, https://github.com/YangHang0210/mcp-feedback-ultra/issues
Author-email: YangHang <yanghang0210@gmail.com>
License-File: LICENSE
Keywords: ai,cross-platform,desktop-app,development,dual-interface,feedback,interactive,mcp,tauri,web-ui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Environment :: Web Environment
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.11
Requires-Dist: aiohttp<4.0.0,>=3.8.0
Requires-Dist: fakeredis<2.35.0,>=2.0.0
Requires-Dist: fastapi<1.0.0,>=0.115.0
Requires-Dist: fastmcp<2.15.0,>=2.14.0
Requires-Dist: jinja2<4.0.0,>=3.1.0
Requires-Dist: mcp<2.0.0,>=1.9.3
Requires-Dist: psutil<8.0.0,>=7.0.0
Requires-Dist: starlette<1.0.0,>=0.46.0
Requires-Dist: uvicorn<1.0.0,>=0.30.0
Requires-Dist: websockets<17.0.0,>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# MCP Feedback Ultra

MCP Feedback Ultra 是一个用于 AI 辅助开发的交互式反馈服务器，支持 Web UI 和桌面应用双界面模式。

**原始项目:** [noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp)

## 核心特性

- **双界面支持**：Web UI（浏览器）+ 桌面应用（原生应用）
- **智能环境检测**：自动识别 SSH Remote、WSL 等特殊环境
- **交互式反馈**：AI 完成任务后主动收集用户反馈
- **跨平台支持**：Windows、macOS、Linux

## 快速开始

### 安装

```bash
uvx mcp-feedback-ultra@latest
```

### MCP 配置

在 Cursor 的 MCP 配置文件中添加：

```json
{
  "mcpServers": {
    "mcp-feedback-ultra": {
      "command": "uvx",
      "args": ["mcp-feedback-ultra@latest"],
      "timeout": 600,
      "autoApprove": ["interactive_feedback"]
    }
  }
}
```

### 环境变量（可选）

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `MCP_DEBUG` | 调试模式 | `false` |
| `MCP_WEB_HOST` | Web UI 绑定地址 | `127.0.0.1` |
| `MCP_WEB_PORT` | Web UI 端口 | `8765` |
| `MCP_DESKTOP_MODE` | 启用桌面应用模式 | `false` |

## 使用方式

### Web UI 模式（默认）

```json
{
  "mcpServers": {
    "mcp-feedback-ultra": {
      "command": "uvx",
      "args": ["mcp-feedback-ultra@latest"]
    }
  }
}
```

### 桌面应用模式

```json
{
  "mcpServers": {
    "mcp-feedback-ultra": {
      "command": "uvx",
      "args": ["mcp-feedback-ultra@latest"],
      "env": {
        "MCP_DESKTOP_MODE": "true"
      }
    }
  }
}
```

## 开发

### 本地测试

```bash
# 克隆项目
git clone https://github.com/YangHang0210/mcp-feedback-ultra.git
cd mcp-feedback-ultra

# 安装依赖
uv sync --dev

# 测试 Web UI
uv run python -m mcp_feedback_ultra test --web

# 测试桌面应用
uv run python -m mcp_feedback_ultra test --desktop
```

## 常见问题

### SSH Remote 环境无法访问？

设置 `MCP_WEB_HOST` 为 `0.0.0.0` 允许远程访问：

```json
{
  "env": {
    "MCP_WEB_HOST": "0.0.0.0",
    "MCP_WEB_PORT": "8765"
  }
}
```

然后在本地浏览器访问：`http://[远程IP]:8765`

## 许可证

MIT License

## 链接

- **PyPI**: https://pypi.org/project/mcp-feedback-ultra/
- **GitHub**: https://github.com/YangHang0210/mcp-feedback-ultra
- **原始项目**: https://github.com/noopstudios/interactive-feedback-mcp
