🚩 Flag MCP

✨ 什么是“Flag”？

在视觉小说和 Galgame 中，“Flag”（フラグ）是指一个选择触发新故事分支的时刻。一个决定可以改变一切。

Flag MCP 将同样的力量带到了 AI 辅助编码中。当你的 AI 助手遇到十字路口时，它不会盲目猜测 —— 而是会插下一面旗帜，等待你选择路线。

🎮 你是主角。 AI 会在每一个分支点等待你的指令。

💎 每一面旗帜都决定了路线。 不再需要反复进行推测性的重写。

🚀 丰富的交互。 文本、截图、标注 —— 你的全套工具库。

这让 AI 编码从“祈祷它能运行”转变为由你掌控全局的叙事过程。

适用范围：

• 按请求计费的编码方案。

• 希望掌控 AI 行为的开发者。

🔥 使用前后对比

🎯 核心功能

• 🖥️ 深色主题 UI — 适配你工作流的精美原生桌面对话框

• ✅ 路线选择 — 结构化的预定义选项（复选框样式）

• 💬 自由文本 — 当预定义路线不够用时，编写你自己的脚本

• 📷 丰富的媒体工具库

  • 从剪贴板粘贴图像

  • 选择本地文件

  • 截图 + 内置标注工具（矩形、圆形、箭头、画笔、文本、裁剪）

• 🖼️ 提示图像 — AI 可以向你展示图像（本地路径、file://、http(s)://）

• 🔒 安全第一 — 远程图像经过验证、大小限制并异步加载

• 🎨 macOS 优化 — 正确的图标处理和视觉润色

📦 安装

前置要求

• Python >= 3.11

• uv (推荐) 或 pip

快速安装

git clone https://github.com/pauoliva/interactive-feedback-mcp.git
cd interactive-feedback-mcp
uv sync

⚙️ 配置

添加到你的 MCP 客户端配置中：

Cursor (mcp.json) / Claude Desktop (claude_desktop_config.json)：

{
  "mcpServers": {
    "interactive-feedback": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/interactive-feedback-mcp",
        "run",
        "server.py"
      ],
      "timeout": 900000,
      "autoApprove": ["interactive_feedback"]
    }
  }
}

⚠️ 注意：Cursor 的超时时间单位为毫秒（900000 = 15 分钟）。某些客户端使用秒，请相应调整。

🚩 interactive_feedback 工具

参数

返回值

• 来自用户的文本反馈

• 可选的图像附件（作为 MCP 图像内容块）

🧙 专业提示

推荐的 Agent 规则

将其添加到你的 AI 助手自定义指令中：

If requirements are unclear, call interactive_feedback before implementing.
Present predefined options whenever possible — give the user clear route choices.
Before finishing a task, call interactive_feedback once more for final confirmation.

环境变量

🛡️ 安全与可靠性

• ✅ 远程图像通过内容类型 (image/*) 进行验证

• ✅ 大负载通过大小上限进行拦截

• ✅ 异步获取保持 UI 响应

• ✅ 本地文件仅在明确引用时读取

📄 许可证

MIT 许可证 — 随意分叉、插旗、交付。

🚩 插下你的旗帜。书写你自己的路线。

献给那些拒绝在自己的代码库中充当 NPC 的开发者，用心制作 💜。