JSONBuddy Data Validator

jsonbuddy

JSONBuddy 是一款适用于 Windows 的 JSON 编辑器和验证器，支持 Draft 4、6、7、2019-09 和 2020-12。它包含 JSON 文本和网格编辑器、语法检查和架构验证功能，还提供独特的 JSON 架构分析器和调试器。 JSONBuddy 还允许用户导入 CSV 文本并将 JSON 导出为 CSV，并包含一项利用 JSON 架构信息的智能自动补全功能。其他功能包括括号高亮、JSON 美化和代码折叠。 JSONBuddy 可用于创建和修改 JSON 内容或 JSON Schema 文件，并提供网格样式的编辑器，简化 JSON 文本的创建和编辑。

ValBuddy CLI Agent 插件

可安装的 valbuddy-cli 插件与仓库中的其他内容隔离，位于 plugins/valbuddy-cli。其核心功能永久免费，支持在 Windows 上本地验证 JSON、JSON Schema 和 XML。可选的高级操作需单独获取许可证。

插件入口：

• plugins/valbuddy-cli/plugin.json
• plugins/valbuddy-cli/skills/valbuddy-cli/SKILL.md
• plugins/valbuddy-cli/README.md
• plugins/valbuddy-cli/LICENSE
• .github/plugin/marketplace.json
• MARKETPLACE.md

从仓库根目录使用 GitHub Copilot CLI 进行本地测试：

copilot --plugin-dir ./plugins/valbuddy-cli

从 JSONBuddy 官方 Marketplace 安装：

copilot plugin marketplace add Clemens-U/jsonbuddy
copilot plugin install valbuddy-cli@jsonbuddy
copilot plugin list

也可以从新的仓库路径将该技能直接安装到 Codex：

python "$env:CODEX_HOME\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo Clemens-U/jsonbuddy --path plugins/valbuddy-cli/skills/valbuddy-cli

该插件需要 Windows，并且需要单独安装可提供 valbuddy.exe 的 JSONBuddy 或 XML ValidatorBuddy。插件目录采用 MIT 许可证，不包含专有可执行文件。有关先决条件、示例和许可证限制，请参阅插件 README。

使用免费的 JSON 验证器命令行工具

• 从此仓库下载适用于 Windows® 的免费 JSON 验证器命令行工具。
• 安装简单。只需运行 Windows® 安装程序，无需额外配置。
• 使用 JSON 验证器生成详细的错误报告。
• 也支持 XML/W3C 验证（使用 Apache Xerces 解析器）。

使用示例：

valbuddy.exe -v -verbose -s "D:\Examples\Library\library_schema.json" "D:\Examples\Library\library.json" "D:\Examples\Library\library_invalid.json"

不带任何参数调用 "valbuddy.exe"，即可在控制台窗口中查看选项列表。

验证输出：

D:\Examples\Library\library.json: valid

D:\Examples\Library\library_invalid.json: invalid
Did not find the following required properties: [title]
Input location: /bib/book/2
Schema location: /properties/bib/properties/book/items

Finished processing

JSONBuddy Core API MCP 服务

本项目为 JSONBuddy Core API 提供兼容 MCP 的接口，可通过安全、高性能的 HTTP 服务执行针对架构的 JSON 验证并生成架构文档（HTML）。该服务提供两个端点（/validator/validate 和 /validator/validate-simple），以支持灵活的架构验证场景。MCP 客户端和 AI Agent 可以使用随附的 mcp.json 定义和标准 API 密钥身份验证来集成此 API。

C# wrapper nuget 包

请查看 dotnet wrapper 文件夹，了解有关 C# wrapper 库的更多信息，以便在 .NET 项目中使用 JSON Schema 验证和其他功能。

使用 C++ DLL 轻松验证 JSON Schema

• 将 dll 文件夹中的 jsonvalidator.dll、.lib 和 .h 文件添加到项目中。
• 别忘了将 dll 添加到 C++ 解决方案的输出文件夹。

示例代码：

JSONSchemaSubSchemaResult::JSONSchemaSubSchemaResultsT out_results;
JSONSchemaValidator* json_validator = NewJSONSchemaValidator();

json_validator->SetJSONSchema("C:\\Users\\Clemens\\Dokumente\\JSONBuddy\\Examples\\Library\\library_schema.json", JSONSchemaValidator::TJSONSchemaSchemaID::k_nJSONSchemaIDDraft202012);
std::string json_instance = "{\"bib\":{\"book\":[{\"author\":[\"Clemens\",\"Stevens\"],\"publisher\":\"Addison-Wesley\"},{\"title\":1}]}}";

if (json_validator->ValidateJSONDocument(json_instance, 0, out_results))
{
    JSONSchemaSubSchemaResult::JSONSchemaSubSchemaResultsItrT find_invalid = std::find_if(out_results.begin(), out_results.end(),
        [](JSONSchemaSubSchemaResult::JSONSchemaSubSchemaResultsT::value_type& the_result) { return !the_result.m_bValid; });

    if (find_invalid != out_results.end())
    {
        std::cout << "The data is invalid.\n";
        std::cout << "Location: " << find_invalid->m_strJSONPointer << "\n";
    }
    else
        std::cout << "The data is valid.\n";
}
else
    std::cout << "The validation was not executed.\n";

json_validator->Free();