Jsonschema Validator Mcp

Created By

EienWolf5 months ago

A comprehensive JSON Schema validation server implementing the Model Context Protocol (MCP) with support for JSON Schema Draft 2020-12, external references, schema management, and real-time streaming validation.

# json-schema

# validation

Overview Content Tools Comments

Overview

JSON Schema Validator MCP Server - Overview

What is it?

A Model Context Protocol (MCP) server that provides comprehensive JSON Schema validation capabilities to AI assistants like Claude and GitHub Copilot. It validates JSON data, manages schema collections, and generates schemas from sample data.

Key Capabilities

🎯 Core Functionality

JSON Schema Draft 2020-12 validation with full specification support
Schema Management - Store, retrieve, update, and delete schemas in organized collections
Schema Generation - Automatically create schemas from sample JSON data
External References - Resolve schema references from URLs, databases, or local files

🤖 AI Assistant Integration

Claude Desktop - Direct integration via MCP configuration
GitHub Copilot - Seamless validation within development workflow
Real-time Validation - Instant feedback during schema development

🏗️ Deployment Options

Python Direct - Simple python mcp_server.py execution
Docker Container - Containerized deployment with volume persistence
Database + Files - PostgreSQL storage with automatic file fallback
File-Only Mode - Zero-configuration local file storage

8 Available Tools

Tool	Purpose	Example Use Case
`validate_json_schema`	Direct validation	Validate API response against schema
`validate_json_from_collections`	Collection-based validation	Validate user data against stored schema
`get_validation_info`	System capabilities	Check validator status and features
`add_update_schema`	Schema management	Store new API schema definition
`delete_schema`	Schema removal	Clean up outdated schemas
`get_schema`	Schema retrieval	Retrieve schema for editing
`list_schemas`	Collection browsing	See all available schemas
`generate_schema`	Schema creation	Create schema from sample JSON

Use Cases

👨‍💻 For Developers

API Validation - Ensure JSON responses match expected schemas
Data Quality - Validate configuration files and data structures
Schema Development - Generate and refine schemas iteratively
Integration Testing - Validate data contracts between services

🤖 For AI Assistants

Code Generation - Validate generated JSON structures
Data Processing - Ensure data transformations maintain schema compliance
Configuration Management - Validate settings and configuration files
Documentation - Generate examples and validate API specifications

Architecture Highlights

🔄 Smart Data Resolution

HTTP/HTTPS URLs → PostgreSQL Database → Local Files

Intelligent fallback strategy ensures reliability even when external resources are unavailable.

🏛️ Modular Design

Validation Handlers - Core JSON validation logic
Schema Handlers - CRUD operations for schema management
Data Manager - Multi-source data resolution
Database Service - PostgreSQL integration with connection pooling

What Makes It Special

✨ Beyond Basic Validation

External Reference Support - Handles complex schema compositions
Intelligent Schema Generation - Creates schemas from real data samples
Multiple Storage Options - Database, files, or hybrid approaches
Real-time Streaming - Web interface with live validation feedback

🚀 Production Ready

Docker Support - Containerized deployment with health checks
Database Integration - PostgreSQL with automatic table creation
Comprehensive Testing - Full unit test coverage with mocking
Error Handling - Graceful fallback and detailed error reporting

🔮 Future Roadmap

DXT Package - One-command installation following Anthropic's pattern
AI-Enhanced Features - Natural language to schema conversion
Multi-Format Support - XML, classes, and database table schemas
Advanced Analytics - Schema usage patterns and optimization

Resources

Full Documentation: README.md
Detailed Guide: PROJECT_DESCRIPTION.md
Future Plans: ROADMAP.md
Web Demo: client_example.html

Ready to validate? Start with python mcp_server.py and integrate with your favorite AI assistant! 🚀

Server Config

{
  "mcpServers": {
    "jsonschema-validator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "./schemas:/app/.schemas",
        "jsonschema-mcp-server:1.0.0"
      ]
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

WindsurfThe new purpose-built IDE to harness magic

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

DeepChatYour AI Partner on Desktop

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

Serper MCP ServerA Serper MCP Server

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Amap Maps高德地图官方 MCP Server

TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.