MCP 服务器

mcp-interactive

A MCP server that collects interactive user feedback during AI-assisted development, reducing unnecessary tool calls and costs by enabling AI to confirm with users.

README

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）