reviewzy

사용자 대면 텍스트를 위한 인간 참여형 mcp 리뷰: 에이전트가 등록하고, 사람이 승인하며, 이후 세션이 적용합니다

CLI, TUI, 웹 UI, 웹사이트 전반의 사용자 대면 카피를 대량 감사하고 재작성하며, 문구 작성은 사람의 몫으로 유지됩니다.

reviewzy는 인간 참여형 카피 리뷰를 위한 자체 호스팅 대시보드이자 mcp 서버입니다. 코딩 에이전트는 작성하거나 재작성하려는 정확한 문자열을 등록합니다. 사람은 대시보드에서 각 항목을 작성하거나 승인합니다. 이후 에이전트 세션은 승인된 문구를 가져와 그 자리에 적용합니다. i18n 키도 콘텐츠 레이어도 없습니다. 각 항목은 이미 존재하는 문자열을 가리킵니다.

항목 등록:

{
  "project": "my-app",
  "entries": [
    {
      "repo": "https://github.com/me/my-app",
      "file": "src/cli/main.ts",
      "anchor_text": "error: something went wrong",
      "agent_draft": "error: could not reach the reviewzy daemon",
      "file_content": "#!/usr/bin/env bun\nconsole.error(\"error: something went wrong\")\n",
      "constraints": { "max_len": 48, "tone": "plain, lowercase" }
    }
  ],
  "filed_by": "help-text-audit"
}

호출은 항목을 draft 상태로, 배치의 대시보드 링크와 함께 응답합니다:

{
  "batch_id": "01M060XY9GNK6ANVENN4Y4MK7N",
  "results": [
    { "id": "01M060XY9GNK6ANVENN4Y4MK7P", "status": "draft", "deduped": false, "updated": false }
  ],
  "dashboard_url": "http://127.0.0.1:3123/?project=my-app"
}

왜

• 파일 + 스니펫 앵커, i18n 키 없음: 적용(apply-back)은 제자리 대상 치환입니다.

• 사람이 작성하고 에이전트가 적용: 상태 머신은 서버가 강제하며, 대시보드만 approved 또는 rejected 상태에 도달할 수 있습니다.

• 프로젝트별 스타일 가이드를 mcp 리소스로 제공: 전역 가이드와 병합되어 fetch_approved에 포함됩니다.

• 추가 전용 개정 이력: 모든 저장은 되돌릴 수 있으며, 이력은 보관 후에도 유지됩니다.

• ntfy 및 웹훅 알림, 보관 보존: 등록 배치마다 한 번 알림을 보내며, 적용된 항목은 ARCHIVE_AFTER_DAYS 후 보관됩니다.

Related MCP server: approval-gate

작동 방식

설치

bunx reviewzy@latest

bun >= 1.3이 필요합니다(스토어는 bun:sqlite이며 bun 전용입니다. npx 형태는 없습니다). 셸은 최초 사용 시 머신당 공유 데몬 하나를 생성합니다.

체크아웃에서:

bun install
bun run daemon

Claude Code 플러그인으로 사용

이 저장소는 플러그인으로, MCP 서버를 등록하고 /reviewzy 슬래시 명령과 reviewzy 스킬을 추가합니다.

/plugin marketplace add uwuclxdy/reviewzy
/plugin install reviewzy@reviewzy

npm 형태와 동일한 bun 요구 사항이 적용됩니다.

사용법

curl http://127.0.0.1:3123/health

{"name":"reviewzy","version":"0.1.0","pid":4172598,"nonce":"881f0e93-8dde-4c75-b559-d2e3d3b223f0","startedAt":"2026-08-16T19:31:28.640Z"}

대시보드를 열려면 http://127.0.0.1:3123/에 접속하세요.

설정

.env.example을 .env로 복사하고 편집하세요. 모든 키는 선택 사항이며, 잘못된 값이 있으면 시작이 거부됩니다.

자격 증명이 설정되지 않은 상태로 두면 해당 표면은 루프백 전용으로 유지되고 시작 시 경고가 표시됩니다.

통합

mcp 클라이언트를 reviewzy에 연결하여 등록을 시작하세요:

{
  "mcpServers": {
    "reviewzy": {
      "command": "bunx",
      "args": ["reviewzy@latest"]
    }
  }
}

엔드포인트는 상태 비저장 2026-07-28 mcp 개정판을 사용합니다.

비교

차단형 인간 참여 mcp 계열은 호출마다 대화상자를 띄웁니다. 대기열도, 지속성도, 대시보드도 없습니다.

자주 묻는 질문

AI가 생성한 텍스트가 코드에 들어가기 전에 어떻게 승인하나요? 에이전트가 문자열을 초안으로 등록하면, 대시보드에서 작성하거나 승인하고 에이전트가 적용합니다.

AI 에이전트가 i18n 키 없이 제 CLI 도움말 텍스트를 재작성할 수 있나요? 네. 항목은 현재 정확한 문자열에 앵커를 두며, 적용은 대상 치환입니다.

코드베이스의 모든 사용자 대면 문구를 일괄 재작성하려면 어떻게 하나요? 프로젝트별로 배치를 등록하고, 대시보드에서 프로젝트 또는 배치별로 그룹화한 다음, 전후 diff와 함께 일괄 승인하고 이후 에이전트 세션이 가져와 적용하게 하세요.

에이전트가 읽는 스타일 가이드를 업데이트하려면 어떻게 하나요? 대시보드의 /style-guide에서 편집하세요. 저장된 편집은 최대 60초 안에 에이전트에게 도달합니다.

개발

bun run check  # tsc --noEmit && bun test

라이선스

AGPL-3.0. 자체 호스팅은 자체 호스팅으로 유지됩니다. 이를 감싸는 SaaS는 변경 사항을 공개해야 합니다.