Agent JSON Reliability

Agent JSON Reliability

为 AI Agent 提供确定性的 JSON 修复和 JSON Schema 验证。
无需大模型。遇到歧义时安全拒绝。

状态=BETA 0.1.0 · GitHub · PyPI · 官方 MCP 注册表

问题： Agent 会输出格式错误的 JSON（代码围栏、尾随逗号、单引号）。此工具会检查、安全修复并验证文本是否符合 Schema。无需大模型。不编造值。

路径	费用
本地 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 Agent 和软件经常会输出格式错误的 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

修复前 / 修复后（安全修复）

格式错误的 Agent 输出：

{
  "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 且结果符合要求：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

检查、验证、修复和 MCP 服务均免费。POST /v1/json/reliable 会返回 HTTP 402，直到 x402 PAYMENT-SIGNATURE 完成在 Base（eip155:8453）上通过 PayAI 支付的 3000 个 USDC 最小单位（0.003）。

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 以及检查／验证／修复功能免费。