🚩 Flag MCP

✨ 「Flag」とは？

ビジュアルノベルやギャルゲーにおいて、「フラグ」（flag）とは、選択肢が新しい物語の分岐を引き起こす瞬間のことです。一つの決断がすべてを変えます。

Flag MCPは、その力をAI支援コーディングにもたらします。AIアシスタントが岐路に立ったとき、推測するのではなく、フラグを立ててあなたがルートを選択するのを待ちます。

🎮 あなたが主人公です。 AIはすべての分岐点で待機します。

💎 すべてのフラグがルートを形作ります。 推測による書き直しはもう必要ありません。

🚀 リッチな対話。 テキスト、スクリーンショット、アノテーション — あなたの武器をフル活用できます。

これにより、AIコーディングは「うまくいくことを願う」ものから、あなたがコントローラーを握る物語へと変わります。

適用範囲:

• リクエスト単位で課金されるコーディングプラン。

• AIの挙動を制御したい開発者。

🔥 Before & After

🎯 主な機能

• 🖥️ ダークテーマ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画像コンテンツブロックとして）

🧙 プロのヒント

推奨エージェントルール

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になることを拒む開発者のために、💜を込めて作成。