reviewzy

ユーザー向けテキストのヒューマンインザループ型mcpレビュー: エージェントが提出し、人間が承認し、後のセッションが適用

CLI、TUI、Web UI、Webサイトにわたってユーザー向けの文章を一括監査・書き換え。散文の執筆は引き続き人間が担当。

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キー不要: 書き戻しはその場での対象を絞った置換

• 人間が執筆、エージェントが適用: ステータス管理はサーバー側で強制されます。approved または rejected に到達できるのはダッシュボードだけです。

• mcpリソースとしてのプロジェクト別スタイルガイド: グローバルガイドとマージされ、fetch_approved に埋め込まれます。

• 追記専用のリビジョン履歴: すべての保存は取り消し可能です。履歴はアーカイブ後も残ります。

• ntfyとWebhook通知、アーカイブ保持: 提出バッチごとに1回通知します。適用済みエントリは ARCHIVE_AFTER_DAYS 後にアーカイブされます。

Related MCP server: approval-gate

しくみ

インストール

bunx reviewzy@latest

bun >= 1.3 が必要です（ストアはbun:sqliteで、bun専用です。npx版はありません）。このシムは初回使用時にマシンごとに共有デーモンを1つ起動します。

チェックアウトから:

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ファミリーは、呼び出しごとにダイアログを表示します。キューも永続化もダッシュボードもありません。

FAQ

AIが生成したテキストをコードに反映する前に承認するには？ エージェントが文字列を下書きとして提出するので、ダッシュボードで執筆または承認し、エージェントが適用します。

AIエージェントはi18nキーなしでCLIのヘルプテキストを書き換えられますか？ はい。エントリは現在の正確な文字列にアンカーされ、書き戻しは対象を絞った置換です。

コードベース内のユーザー向け文章を一括書き換えするには？ プロジェクトごとにバッチを提出し、ダッシュボードでプロジェクトまたはバッチごとにグループ化し、変更前/変更後の差分を確認して一括承認し、後でエージェントセッションに取得・適用させます。

エージェントが読むスタイルガイドを更新するには？ ダッシュボードの/style-guideで編集します。保存した編集は最大60秒でエージェントに反映されます。

開発

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

ライセンス

AGPL-3.0. セルフホストはセルフホストのままです。これをラップするSaaSは、その変更を公開する必要があります。