Agent JSON Reliability

Agent JSON の信頼性

AI エージェント向けの決定論的な JSON 修復と JSON Schema 検証です。
LLM は使用しません。曖昧な場合は安全に拒否します。

STATUS=BETA 0.1.0 · GitHub · PyPI · 公式 MCP レジストリ

問題： エージェントは不正な JSON（コードフェンス、末尾のカンマ、一重引用符など）を出力します。このツールはそのテキストを検査し、安全に修復して、スキーマに照らして検証します。LLM は使用しません。値を捏造することもありません。

経路	費用
ローカル MCP（uvx agent-json-reliability）	無料
ホスト型 POST /v1/json/inspect、/validate、/repair、/mcp	無料
ホスト型 POST /v1/json/reliable	Base 上で x402 を介して 0.003 USDC

マシンカタログ：https://agent-json-reliability.onrender.com/v1/catalog
スキル：https://agent-json-reliability.onrender.com/skill.md

クイックスタート

uvx agent-json-reliability

MCP クライアントの設定（stdio、公開済みパッケージ）：

{
  "mcpServers": {
    "agent-json-reliability": {
      "command": "uvx",
      "args": ["agent-json-reliability"]
    }
  }
}

AI エージェントやソフトウェアは、不正な JSON を頻繁に出力します。例として、Markdown のコードフェンス、末尾のカンマ、一重引用符、True／False／None、および単一のオブジェクトの前後にある余分な文章などがあります。

Agent JSON Reliability は、この種の問題に対応する決定論的なパイプラインです。

1. 検査 — テキストが JSON かどうか、どのような問題があるかを診断します
2. 安全な修復 — 構造上明確で、曖昧さのない修正のみを適用します
3. 検証 — 必要に応じて、結果を JSON Schema で検証します
4. 構造化診断 — valid_original、repaired、valid_final、schema_valid、unsafe_or_ambiguous、changes、errors

これは汎用的な jsonschema ラッパーではありません。欠落している意味上の値を補うことはありません。入力が曖昧な場合は拒否します。

主な HTTP エンドポイント（ローカル／セルフホスト）：POST /v1/json/reliable

MCP ツール（同じコア関数）：reliable_json、validate_json、repair_json、inspect_json

修復前／修復後（安全な修復）

不正なエージェント出力：

{
  "text": "```json\n{\"name\":\"alice\",\"age\":30,}\n```"
}

期待される結果（意味的に同等な有効な JSON）：

• valid_original=false
• repaired=true
• valid_final=true
• unsafe_or_ambiguous=false
• json → {"name":"alice","age":30}

スキーマが指定され、それを満たす場合：schema_valid=true。

安全な拒否（曖昧な入力）

{"user": のように途中で切れた入力は JSON を意図したものですが、キーや値を捏造せずに決定論的に修復することはできません。

期待される結果：

• HTTP 200（文書化された安全な応答）
• valid_final=false
• unsafe_or_ambiguous=true または repaired=false

正しい拒否を製品の失敗として扱わないでください。

ローカルで実行する（Hunter 不要）

python -m pip install -r requirements.txt
python serve.py

デフォルトでは 127.0.0.1:8770 にバインドします。プロセスを自分で公開する場合に限り、PUBLIC_BASE_URL に HTTPS オリジンを設定してください。一時的なトンネルのホスト名を正規 URL としてコミットしないでください。

ホスト型 API（x402）

公開オリジン：https://agent-json-reliability.onrender.com

inspect／validate／repair／MCP は引き続き無料です。POST /v1/json/reliable は、Base（eip155:8453）上で PayAI を介した 3000 atomic USDC（0.003）の決済が完了するまで、HTTP 402 を返します。x402 の PAYMENT-SIGNATURE が必要です。

curl -s -D - -o /tmp/ajr.json -X POST https://agent-json-reliability.onrender.com/v1/json/reliable \
  -H "content-type: application/json" \
  -d '{"text":"{'\''a'\'': 1}"}'
# Expect: HTTP/1.1 402  and a PAYMENT-REQUIRED header. Do not send a signature unless you intend to pay.

HTTP の例

examples/curl.md、examples/python.py、examples/javascript.js を参照してください。

リモートの例では https://agent-json-reliability.onrender.com を使用します。ローカルのデフォルトは http://127.0.0.1:8770 です。

共有 URL（任意、未検証のテレメトリータグ）：

• /?source=github
• /?source=mcp-registry
• /?source=api-directory

MCP（stdio — 永続型）

パッケージのトランスポートは、一時的な公開 URL に依存しません。uvx（上記）を推奨します。チェックアウトから実行する場合：

{
  "mcpServers": {
    "agent-json-reliability": {
      "command": "python",
      "args": ["-m", "products.gateway.mcp_stdio"]
    }
  }
}

リモート HTTP MCP（POST /mcp）は、実行中のインスタンス向けです。

マシンによる検出

• ホスト済みのオリジン：https://agent-json-reliability.onrender.com
• GET /.well-known/agent-services.json
• GET /.well-known/agent.json
• GET /.well-known/x402
• GET /openapi.json
• GET /llms.txt · GET /llms-full.txt · GET /AGENTS.md · GET /sitemap.xml · GET /robots.txt
• POST /mcp JSON-RPC（tools/list、tools/call）

このパッケージに含まれないもの

Hunter の市場データベース、非公開レポート、Windows のユーザーパス、コレクター、ウォレットは、このパッケージに含まれません。ホスト済みの /v1/json/reliable は x402 による有料サービスです。ローカルの MCP と inspect／validate／repair は無料です。