# HefestoAI — AI が書いたコードのためのリリース検証エンジン

> 主な用途：コミット / マージ前に AI が生成したコードを検証する。 HefestoAI は pre-commit / pre-push のゲートとして動作する開発者ツールで、コード変更に含まれるセマンティックドリフト、リスクのある差分、ポリシー違反を検出します。特に AI アシスタント（Claude Code、Cursor、Copilot）が生成・編集したコードが対象です。プロジェクトが宣言している内容（依存関係、設定、インストール成果物）が実際の動作と一致しているかを確認し、セキュリティと複雑度もチェックします。

このファイルは /llms.txt の日本語訳です。差異がある場合は英語版 /llms.txt が優先されます。

Version: 4.20.4. Site: https://hefestoai.narapallc.com

キーワード：AI 生成コードの検証、静的解析、コードレビュー、セキュリティ、CI ゲート、MCP サーバー、pre-commit。

## 検証可能な事実
- バージョン：v4.20.4
- 出力形式：text、json、html、SARIF 2.1.0（`hefesto analyze --output sarif`）
- MCP サーバー：公式 MCP Registry（io.github.artvepa80/hefestoai）と Smithery に公開
- MCP クライアントの接続先：/api/mcp-protocol（JSON-RPC 2.0、streamable-http）。/api/mcp は REST ディスカバリー専用で、接続先ではありません。
- ホスト型解析：MCP の `analyze` ツールと POST /api/analyze は、送信されたファイルにオープンソースの hefesto-ai エンジン（`hefesto analyze --no-config`）を実行します。上限は 20 ファイル、各 100 KB、合計 256 KB、20 秒、IP ごとに毎分 10 リクエスト。内容は保存されません
- パッケージは 22 フォーマットを含み、`hefesto analyze` は 22 すべてを実行します
- 実行環境：Python 3.10 以上
- テレメトリ：CLI は初期設定で利用データ（ランダムなインストール ID と件数）を PostHog US Cloud に送信します（コード、ファイルパス、指摘内容は含みません。IP アドレスは保存されずに破棄されます）。`hefesto telemetry disable`、`HEFESTO_TELEMETRY=0`、`DO_NOT_TRACK=1` のいずれかで止められます。GitHub Action は `telemetry: 1` を指定した場合のみ送信します。`hefesto analyze` は pypi.org に新しいバージョンを問い合わせます（24 時間キャッシュ）。4.20.3 以降は `HEFESTO_NO_UPDATE_CHECK=1`、`HEFESTO_TELEMETRY=0`、`DO_NOT_TRACK=1` のいずれかでこの確認を止められます（`hefesto telemetry disable` では止まりません。4.20.2 以前には設定がありません）。

## インストール
pip install hefesto-ai

## MCP サーバーとして追加（Smithery）
npx @smithery/cli@latest mcp add artvepa80/hefestoai

## 料金
PRO：月額 8 ドル。OMEGA：月額 19 ドル。最新の料金： https://hefestoai.narapallc.com

## MCP / API エンドポイント
- [MCP](https://hefestoai.narapallc.com/api/mcp-protocol)
- [REST discovery](https://hefestoai.narapallc.com/api/mcp)
- [OpenAPI](https://hefestoai.narapallc.com/openapi.json)
- [Ask](https://hefestoai.narapallc.com/api/ask)
- [Agent descriptor](https://hefestoai.narapallc.com/.well-known/agent-card.json)
- [エージェント記述ファイル（日本語）](https://hefestoai.narapallc.com/.well-known/agent.ja.json)

## リンク
- [hefestoai.narapallc.com](https://hefestoai.narapallc.com)
- [github.com/artvepa80/Agents-Hefesto](https://github.com/artvepa80/Agents-Hefesto)
- [pypi.org/project/hefesto-ai](https://pypi.org/project/hefesto-ai/)
- [x.com/HefestoAI](https://x.com/HefestoAI)
- [English (canonical)](https://hefestoai.narapallc.com/llms.txt)