🚩 Flag MCP

✨ "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 이미지 콘텐츠 블록으로)

🧙 전문가 팁

권장 에이전트 규칙

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가 되기를 거부하는 개발자들을 위해 💜로 제작되었습니다.