Metadata-Version: 2.4
Name: mcp-interactive
Version: 0.1.4
Summary: MCP server for interactive feedback collection in AI-assisted development workflows.
Project-URL: Homepage, https://github.com/RealAlexandreAI/mcp-interactive
Project-URL: Repository, https://github.com/RealAlexandreAI/mcp-interactive
Project-URL: Issues, https://github.com/RealAlexandreAI/mcp-interactive/issues
Author: RealAlexandreAI
License-File: LICENSE
Keywords: ai,development,feedback,interactive,mcp,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>=3.13.3
Requires-Dist: fastapi>=0.135.1
Requires-Dist: fastmcp>=3.1.0
Requires-Dist: jinja2>=3.1.6
Requires-Dist: mcp>=1.26.0
Requires-Dist: psutil>=7.2.2
Requires-Dist: uvicorn>=0.41.0
Requires-Dist: websockets>=16.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
Requires-Dist: pytest>=9.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# mcp-interactive

[English](README.en.md) | **简体中文**

MCP 服务器，用于在 AI 辅助开发过程中收集用户的交互式反馈。通过引导 AI 与用户确认而非自行猜测，减少不必要的工具调用，降低平台成本，提高开发效率。

<div align="center">
  <img src="docs/preview.png" width="800" alt="mcp-interactive Web UI" />
</div>

## 工作流程

1. AI 调用 `interactive_feedback` 工具
2. 自动打开浏览器界面（Web UI）
3. 用户输入反馈文本、上传截图、选择常用提示词
4. 通过 WebSocket 实时传递给 AI
5. AI 根据反馈调整行为或结束任务

## 安装

```bash
pip install uv
```

## 配置

将以下内容添加到 MCP 配置文件：

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

支持的 AI 平台：[Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai)

### 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `MCP_WEB_HOST` | Web UI 监听地址 | `127.0.0.1` |
| `MCP_WEB_PORT` | Web UI 端口 | `9766` |
| `MCP_LANGUAGE` | 界面语言 (`zh-CN` / `en`) | 自动检测 |
| `MCP_DEBUG` | 调试模式 | `false` |

SSH 远程开发时，将 `MCP_WEB_HOST` 设为 `0.0.0.0` 以允许远程访问，或使用 SSH 端口转发。

## 功能

- **提示词管理** - 常用提示词的增删改查和智能排序
- **自动定时提交** - 1-86400 秒可配置定时器，支持暂停/恢复
- **图片上传** - 拖放、粘贴，支持 PNG/JPG/GIF/BMP/WebP
- **多语言** - 简体中文、English，即时切换
- **WebSocket 实时通信** - 状态监控、自动重连

## 开发

```bash
git clone https://github.com/RealAlexandreAI/mcp-interactive.git
cd mcp-interactive
uv sync

# 测试
make test          # 单元测试
make test-web      # Web UI 测试

# 代码检查
make check         # 完整检查（lint + format + type）
```

## 致谢

- 原始项目：[noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp) by [Fabio Ferreira](https://x.com/fabiomlferreira)
- 上游 fork：[Minidoracat/mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced)

## License

MIT
