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

Metadata

Release files for mcp-interactive 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-interactive 0.1.8
File	Size	Uploaded	Provenance
mcp_interactive-0.1.8.tar.gz	11.2 MB	Aug 31, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-interactive 0.1.8
File	Interpreter	ABI	Platform	Reset
mcp_interactive-0.1.8-py3-none-any.whl 8.6 MB Aug 31, 2026 Without provenance	Python 3	none	any	Details

Total release size: 19.8 MB

Release files / mcp_interactive-0.1.8.tar.gz

Download URL	mcp_interactive-0.1.8.tar.gz
Size	11.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`ad4d41b0b8ff283546161fafdcc4cc8a5ad57291035f3a418e812679624bb3e1`
BLAKE2b-256 checksum How to use checksums	`1d1c7e20b15cb6b6932f48c3cc0a12a6d13cba8bedc1fa53a36c6e58dd492253`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / mcp_interactive-0.1.8-py3-none-any.whl

Download URL	mcp_interactive-0.1.8-py3-none-any.whl
Size	8.6 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`cabd9b2cf565e19bc5ef82e0d256bf2502a7d4b3ceb66d06a287d68bcbea14bd`
BLAKE2b-256 checksum How to use checksums	`305fd3c5a8847a5a8fe7175f159203fb226e681fac93312dc6ce265de684582f`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Security for mcp-interactive 0.1.8

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.