mcp-interactive
English | 简体中文
MCP 服务器，用于在 AI 辅助开发过程中收集用户的交互式反馈。通过引导 AI 与用户确认而非自行猜测，减少不必要的工具调用，降低平台成本，提高开发效率。
工作流程
- AI 调用
interactive_feedback工具 - 自动打开浏览器界面（Web UI）
- 用户输入反馈文本、上传截图、选择常用提示词
- 通过 WebSocket 实时传递给 AI
- AI 根据反馈调整行为或结束任务
安装
pip install uv
配置
将以下内容添加到 MCP 配置文件：
{
"mcpServers": {
"mcp-interactive": {
"command": "uvx",
"args": ["mcp-interactive@latest"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}
支持的 AI 平台：Cursor | Cline | Windsurf | Augment | Trae
环境变量
| 变量 | 说明 | 默认值 |
|---|---|---|
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 实时通信 - 状态监控、自动重连
开发
git clone https://github.com/RealAlexandreAI/mcp-interactive.git
cd mcp-interactive
uv sync
# 测试
make test # 单元测试
make test-web # Web UI 测试
uv run python scripts/mcp_stdio_smoke.py # MCP stdio 握手烟测（initialize/list/call，默认非阻塞）
uv run python scripts/mcp_stdio_smoke.py --exercise-interactive --call-timeout 5
# 代码检查
make check # 完整检查（lint + format + type）
致谢
- 原始项目：noopstudios/interactive-feedback-mcp by Fabio Ferreira
- 上游 fork：Minidoracat/mcp-feedback-enhanced
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mcp_interactive-0.1.8.tar.gz
(11.2 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_interactive-0.1.8.tar.gz.
File metadata
- Download URL: mcp_interactive-0.1.8.tar.gz
- Upload date:
- Size: 11.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad4d41b0b8ff283546161fafdcc4cc8a5ad57291035f3a418e812679624bb3e1
|
|
| MD5 |
20b0be3ec2cc8fc3b843764746e7647c
|
|
| BLAKE2b-256 |
1d1c7e20b15cb6b6932f48c3cc0a12a6d13cba8bedc1fa53a36c6e58dd492253
|
File details
Details for the file mcp_interactive-0.1.8-py3-none-any.whl.
File metadata
- Download URL: mcp_interactive-0.1.8-py3-none-any.whl
- Upload date:
- Size: 8.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cabd9b2cf565e19bc5ef82e0d256bf2502a7d4b3ceb66d06a287d68bcbea14bd
|
|
| MD5 |
08aab4823b26e247ccbd23e715fa546d
|
|
| BLAKE2b-256 |
305fd3c5a8847a5a8fe7175f159203fb226e681fac93312dc6ce265de684582f
|
