gutsy

gutsy-mcp

コーディングエージェント向けのローカルな妥当性チェックです。Claude Code、Codex、Cursor、Copilotが rm -rfを実行したり、強制プッシュしたり、デプロイしたり、何かを送信したりする前に、 gut_checkを呼び出すと、その操作が意図したもので安全かどうかを示す調整済みの確率と、 proceed（続行）、confirm（ユーザーに先に確認）、block（ブロック）のいずれかの推奨が返されます。

gutsy （0.8B、775 MB GGUF）を使ってCPU上で動作します。 API呼び出しはなく、呼び出しごとの費用もかかりません。コードがマシンの外に出ることもありません。

どのようなものか、どのようなものではないか

必要な場面で操作にひと手間加える、素早いセカンドオピニオンです。セキュリティ境界ではありません。エージェントが呼び出すかどうかを決め、参照するコンテキストもエージェントが記述します。また、0.8Bモデルは曖昧な状況や複数ステップにわたるルールへの対応が苦手です（モデルカードを参照）。通常の権限設定はそのまま有効にしてください。デフォルトのしきい値はワークフローに合わせて調整されていません。確率をログに記録して調整してください。

1. gutsyランタイムを起動する

git clone https://github.com/kouhxp/gutsy
pip install -e gutsy/gutsy-inference
hf download kouhxp/gutsy --include "gutsy-0.8b-v04*" --local-dir gutsy/gutsy-inference/models
cd gutsy/gutsy-inference && cp models.example.json models.json
gutsy-inference check && gutsy-inference serve     # http://127.0.0.1:8765

または、GUTSY_INFERENCE_DIR=/path/to/gutsy/gutsy-inferenceを設定すると、gutsy-mcpは初回使用時にランタイムを起動します。

2. MCP サーバーを追加する

Claude Code：

claude mcp add gutsy -- uvx gutsy-mcp

Cursor（.cursor/mcp.json）／Claude Desktop：

{ "mcpServers": { "gutsy": { "command": "uvx", "args": ["gutsy-mcp"] } } }

VS Code（.vscode/mcp.json）：

{ "servers": { "gutsy": { "type": "stdio", "command": "uvx", "args": ["gutsy-mcp"] } } }

Codex（~/.codex/config.toml）：

[mcp_servers.gutsy]
command = "uvx"
args = ["gutsy-mcp"]

次に、いつ使うかをエージェントに指示します（CLAUDE.md、AGENTS.md、.cursor/rules）。

ファイルの削除、Gitの履歴の書き換え、強制プッシュ、データベースへの操作、デプロイ、公開、または何かを送信する前に、gut_checkを呼び出してください。戻り値がproceed以外の場合は、停止して私に確認してください。

3. オプション：Claude Codeのフックで強制する

MCPツールは、エージェントが呼び出すのを忘れると実行されません。このフックは、リスクがありそうなすべてのBashコマンドで実行されます。できるのは確認または拒否のみで、自動承認はしません。

uv tool install gutsy-mcp      # puts gutsy-hook on PATH

.claude/settings.json：

{
  "hooks": {
    "PreToolUse": [
      { "matcher": "Bash", "hooks": [{ "type": "command", "command": "gutsy-hook", "timeout": 60 }] }
    ]
  }
}

デフォルトでは、blockは確認プロンプトになります。即座に拒否するには、GUTSY_HOOK_ALLOW_DENY=1を設定してください。

ツール

gut_check(action, context="", user_request="")は次を返します。

{
  "recommendation": "confirm",
  "reason": "Not confident enough to proceed without the user.",
  "p_intended": 0.41,
  "p_reversible": 0.08,
  "verdict_probabilities": {"proceed": 0.22, "confirm": 0.61, "block": 0.17},
  "reject": 0.04,
  "confidence": 0.42
}

環境変数	デフォルト
GUTSY_URL	http://127.0.0.1:8765	ランタイムのURL
GUTSY_INFERENCE_DIR		gutsy-mcpがランタイムを起動できるようにします
GUTSY_MODEL	ランタイムのデフォルト	models.jsonに記載されたモデル名
GUTSY_PROCEED_MIN	0.85
GUTSY_BLOCK_MIN	0.50
GUTSY_API_KEY		serve --api-key-envを実行する場合に使用します

ライセンス：Apache 2.0。