Metadata-Version: 2.4
Name: cursor-feedback-mcp
Version: 2.6.1
Summary: Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual interface support (Web UI and Desktop Application) with intelligent environment detection and cross-platform compatibility.
Project-URL: Homepage, https://github.com/zhajiahe/cursor_feedback_mcp
Project-URL: Repository, https://github.com/zhajiahe/cursor_feedback_mcp
Project-URL: Issues, https://github.com/zhajiahe/cursor_feedback_mcp/issues
Author-email: Minidoracat <minidora0702@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.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.12
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: mcp>=1.9.3
Requires-Dist: psutil>=7.0.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: websockets>=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

# Cursor Feedback MCP

## 🔧 本项目说明
> 感谢[原作者](https://github.com/Minidoracat/mcp-feedback-enhanced)开源了增强的反馈项目。但是有严重bug未修复。

> 感谢[原作者](https://github.com/Huo-zai-feng-lang-li/fix-MCP-Feedback-Enhanced)的反馈项目修复了以下问题并新增功能（但是没有发布pypi）：

### ✅ 已修复问题

1. **超时设置问题**：修复了超时时间永远是 600s 的问题，现已修复默认 24 小时超时
   ，可以长时间等待反馈啦
2. **图片上传问题**：修复了无法上传图片报错序列号错误的问题，现已支持更多类型图
   片 😁🎉
3. **断网重连功能**：新增断网不断链接功能，现在可以离线同一个会话等待（适合使用
   手机热点为电脑提供互联网的场景）

### 本项目实现的内容
1. 发布pypi包，方便无缝集成cursor（uvx），无需本地另外安装

## 📦 安装方式

### 方式一：从 PyPI 安装（推荐）

最简单的使用方式是通过 `uvx` 直接运行：

```bash
# 使用最新版本
uvx cursor-feedback-mcp@latest

# 使用指定版本
uvx cursor-feedback-mcp@2.6.1
```

在 Cursor 中配置：

```json
{
  "mcpServers": {
    "cursor-feedback-mcp": {
      "command": "uvx",
      "args": ["cursor-feedback-mcp@latest"],
      "timeout": 86400,
      "env": {
        "MCP_DEBUG": "false",
        "MCP_WEB_HOST": "127.0.0.1",
        "MCP_WEB_PORT": "8765",
        "MCP_DESKTOP_MODE": "false",
        "MCP_LANGUAGE": "zh-CN"
      },
      "autoApprove": ["interactive_feedback"]
    }
  }
}
```

### 方式二：本地开发安装

如果需要本地定制开发，可以 Fork 本项目到本地：

```bash
# 克隆项目
git clone https://github.com/yourusername/cursor_feedback_mcp.git
cd cursor_feedback_mcp

# 激活虚拟环境（使用 uv）
uv venv
source .venv/bin/activate  # Linux/macOS
# 或
.venv\Scripts\activate  # Windows

# 安装依赖
uv sync
```

在 Cursor 中配置本地版本：

```json
{
  "mcpServers": {
    "cursor-feedback-mcp-local": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/cursor_feedback_mcp",
        "python",
        "-m",
        "mcp_feedback_enhanced"
      ],
      "timeout": 86400,
      "env": {
        "MCP_DEBUG": "false",
        "MCP_WEB_HOST": "127.0.0.1",
        "MCP_WEB_PORT": "8765",
        "MCP_DESKTOP_MODE": "false",
        "MCP_LANGUAGE": "zh-CN"
      },
      "autoApprove": ["interactive_feedback"]
    }
  }
}
```

> **注意**：请将 `/path/to/your/cursor_feedback_mcp` 改为您本地的项目位置，这样可以实现本地高自由度的定制。

## 🚀 发布到 PyPI

如果您想发布自己的版本到 PyPI：

### 1. 准备工作

确保已安装必要的工具：

```bash
uv add --dev twine build
```

### 2. 配置 PyPI 凭证

创建 `~/.pypirc` 文件：

```ini
[distutils]
index-servers =
    pypi

[pypi]
username = __token__
password = pypi-your-api-token-here
```

### 3. 构建和发布

```bash
# 清理旧的构建文件
rm -rf dist/ build/ *.egg-info

# 构建包
uv build

# 检查构建的包
twine check dist/*

# 上传到 PyPI
twine upload dist/*
```

### 4. 测试安装

```bash
# 测试从 PyPI 安装
uvx cursor-feedback-mcp@latest
```

### 📸 界面预览

<div align="center">
  <img src="images/0.png" width="600" alt="MCP Feedback Enhanced 界面预览" />
  <br>
  <em>主界面 - 支持提示管理、自动提交、会话跟踪上传图片等功能</em>
</div>

<div align="center">
  <img src="images/1.png" width="600" alt="MCP Feedback Enhanced 功能展示" />
  <br>
  <em>超时功能展示 - 智能工作流程和现代化体验</em>
</div>

---
