Show HN: Ask-human-mcp – 설정 없이 환각을 막는 human-in-loop 해치

스타트업을 만들면서 Cursor의 AI 에이전트가 존재하지 않아야 할 엔드포인트나 코드를 생성하거나, 문자열을 환각(hallucinate)하거나, 코드를 그냥 이해하지 못하는 문제를 계속 겪었습니다. ask-human-mcp는 에이전트가 막혔을 때마다 일시 중지하고, 루트 디렉터리의 ask_human.md에 answer: PENDING과 함께 질문을 기록한 뒤, 올바른 답변을 채워 넣는 즉시 재개합니다. 문제점: 에이전트가 한 번도 존재한 적 없는 엔드포인트를 외쳐댑니다 확신에 찬 가정을 하고, 당신은 잘못된 단서를 디버깅하느라 몇 시간을 허비합니다 해결책: ask-human-mcp는 에이전트에게 탈출구를 제공합니다. 확신이 없을 때 ask_human()을 호출하고, ask_human.md에 질문을 작성한 뒤 기다립니다. answer: PENDING을 실제 답변으로 바꾸면 에이전트가 계속 진행합니다. 주요 기능: - 제로 설정: pip install ask-human-mcp + .cursor/mcp.json에 한 줄 → 바로 사용 가능 - 크로스 플랫폼: macOS, Linux, Windows에서 작동—추가 서버나 웹훅 불필요. - 마크다운 Q\&A: 에이전트가 await ask_human()을 호출하면 질문이 answer: PENDING과 함께 ask_human.md에 기록됩니다. 답변을 작성하면 에이전트가 다시 이어서 진행합니다 - 파일 잠금 & 로테이션: 파일 손상 방지, 대기 중인 질문 수 제한, ask_human.md가 약 50 MB에 도달하면 자동 로테이션 퀵스타트 pip install ask-human-mcp ask-human-mcp --help .cursor/mcp.json에 추가하고 재시작: { "mcpServers": { "ask-human": { "command": "ask-human-mcp" } } } 이제 다음과 같은 호출은: answer = await ask_human( "which auth endpoint do we use?", "building login form in auth.js" ) 다음을 생성합니다: ### Q8c4f1e2a ts: 2025-01-15 14:30 q: which auth endpoint do we use? ctx: building login form in auth.js answer: PENDING answer: PENDING을 실제 엔드포인트(예: `POST /api/v2/auth/login`)로 바꾸면 에이전트가 계속 진행합니다. 링크: github -> https://github.com/Masony817/ask-human-mcp 피드백: 저는 Kallro의 19세 1인 창업자 Mason입니다. 발견하신 버그, 기능 요청, 또는 이상한 엣지 케이스가 있다면 기꺼이 듣고 싶습니다 - 댓글을 남기거나 이슈를 열어주세요! buy me a coffee -> coff.ee/masonyarbrough