mcpField
S
schema

schema

本地服务
github.com/rog0x开发工具032 周前更新
代码仓库

关于 schema

面向 AI Agent 的 MCP 服务，可生成和验证 JSON Schema、生成 TypeScript 类型与模拟数据，并比较不同版本的 Schema。验证结果包含详细路径、数据值和约束信息。

主要功能

  1. 01从示例 JSON 生成 Schema
  2. 02生成 TypeScript 类型和接口
  3. 03提供详细错误以验证数据
  4. 04根据 Schema 创建模拟数据
  5. 05按兼容性分类 Schema 差异

适用场景

  1. 01根据示例数据推导 Schema
  2. 02为 JSON 创建 TypeScript 定义
  3. 03诊断未通过验证的数据
  4. 04检查 Schema 变更的兼容性

MCP 相关

向 MCP 客户端提供 Schema 生成、验证、TypeScript 生成、模拟数据生成和 Schema 比较工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "rog0x-schema": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-schema-tools"
      ]
    }
  }
}
启动命令npx -y @rog0x/mcp-schema-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@rog0x/mcp-schema-tools1.0.1

工具

5

收录的工具列表 · 更新于 3 周前

参数类型必填说明
titlestring否生成的架构的可选标题
samplesarray是用于推断架构的示例 JSON 值数组。示例越多，架构越准确。
detect_enumsboolean否是否从各个样本的字符串字段中检测枚举值（默认：true，至少需要 3 个样本）

详细介绍

mcp-schema-tools

为 AI Agent 提供模式验证和生成工具的 MCP 服务。

工具

generate_json_schema

根据示例 JSON 数据生成 JSON Schema。推断类型、必填字段、格式（邮箱、日期、URI、UUID），并从多个示例中检测枚举模式。

generate_typescript

根据 JSON 数据或 JSON Schema 生成 TypeScript 接口和类型。支持嵌套对象、数组、可选字段、枚举和联合类型。

validate_schema

根据 JSON Schema 验证数据，并提供详细错误信息，包括 JSON 路径、预期类型、实际值以及违反的约束关键字。

mock_from_schema

根据 JSON Schema 生成逼真的模拟数据。智能字段名称检测会生成符合上下文的值：邮箱字段会获得有效邮箱，姓名字段会获得逼真的姓名，电话字段会获得格式化的号码，等等。

diff_schemas

比较两个 JSON Schema，查找新增、移除和变更的字段。识别类型变更和约束变更，并将每项差异归类为破坏性或非破坏性，以便分析向后兼容性。

设置

npm install
npm run build

在 Claude Desktop 中使用

添加到你的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "schema-tools": {
      "command": "node",
      "args": ["path/to/mcp-schema-tools/dist/index.js"]
    }
  }
}

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。