JSON Compare MCP Server (ai.smithery/keremurat-json)

The ai.smithery/keremurat-json MCP server provides a tool to compare two JSON files deeply. Its purpose is order-independent comparison, so differences can be detected without requiring matching key or array order. It identifies discrepancies such as missing and extra elements.

🛠️ Key Features

Deep comparison of two JSON files
Detects differences without worrying about key order or array order
Detects missing and extra items
Described as a JSON compare MCP tool

🚀 Use Cases

Comparing JSON outputs where key/array ordering may vary
Validating that two JSON documents represent the same data despite ordering differences
Identifying structural differences between JSON files

⚡ Developer Benefits

Supports deterministic diffing by ignoring key/array order
Helps locate mismatches such as missing/extra fields or items during comparisons
Implemented as a Python (3.11+) MCP-compatible server

⚠️ Limitations

The provided materials do not specify supported JSON types, size constraints, or error-handling behavior.

🔍 JSON Compare MCP Server

Python MCP Docker Smithery

Derinlemesine ve sıra-bağımsız JSON karşılaştırma MCP tool'u

İki JSON dosyasını akıllıca karşılaştırın, farklılıkları tespit edin!

🎯 Hızlı Başlangıç • 📦 Özellikler • 🚀 Kullanım • 🧪 Test

✨ Özellikler

🔍 Derinlemesine Karşılaştırma - Nested objeler ve array'ler dahil tüm seviyeler
🔀 Sıra-Bağımsız - Property ve obje sıralaması önemli değil
📊 Detaylı Raporlama - Eksik, fazla ve farklı değerlerin detaylı raporu
🎯 Path Tracking - Her farkın tam konumu (örn: root.user.settings.theme)
🏷️ Tip Kontrolü - Değer tiplerini de karşılaştırır
⚡ Hızlı ve Verimli - Optimize edilmiş recursive algoritma

🎯 Hızlı Başlangıç

1. Kurulum

bash

git clone https://github.com/yourusername/json-compare-mcp.git
cd json-compare-mcp
pip install -r requirements.txt

2. MCP Server'ı Başlat

bash

python server.py

3. Test Et

bash

python test_compare.py

📦 Ne İçeriyor?

code

json-compare-mcp/
├── 🐍 app.py              # JSON karşılaştırma implementasyonu
├── 🚀 server.py           # MCP server yapılandırması
├── 🧪 test_compare.py     # Test suite
├── 📋 requirements.txt    # Python bağımlılıkları
├── 🐳 Dockerfile          # Container yapılandırması
├── ⚙️ smithery.yaml       # Smithery deployment config
└── 📁 test_samples/       # Örnek JSON dosyaları
    ├── file1.json
    ├── file2.json
    └── file3_different.json

🚀 Kullanım

MCP Tool: `compare_json`

python

# İki JSON string'ini karşılaştır
compare_json(
    json1='{"name": "Ahmet", "age": 30, "city": "Istanbul"}',
    json2='{"age": 30, "city": "Istanbul", "name": "Ahmet"}'
)

Not: Artık dosya yolu değil, direkt JSON string kullanın!

Çıktı Formatı

json

{
  "status": "different",
  "total_differences": 11,
  "differences": [
    {
      "type": "missing_key",
      "path": "root.user.settings.language",
      "key": "language",
      "file1_value": "tr",
      "message": "Key 'language' exists in file1 but missing in file2"
    },
    {
      "type": "value_mismatch",
      "path": "root.user.name",
      "file1_value": "Ahmet Yılmaz",
      "file2_value": "Mehmet Demir",
      "message": "Value mismatch at 'root.user.name'"
    }
  ],
  "summary": {
    "missing_keys": 1,
    "extra_keys": 2,
    "value_mismatches": 8,
    "type_mismatches": 0
  }
}

🔍 Karşılaştırma Mantığı

Seviye 1: Üst Seviye Obje Karşılaştırma

✅ Her iki JSON'daki üst seviye objeleri/anahtarları tespit et
✅ SIRALAMA ÖNEMLİ DEĞİL - Objeler farklı sırada olabilir
✅ Eksik/fazla objeleri tespit et ve uyar
✅ Eşleşen objeler için Seviye 2'ye geç

Seviye 2: İç Nesne/Property Karşılaştırma

✅ Tüm property'leri karşılaştır
✅ SIRALAMA ÖNEMLİ DEĞİL - Property'ler farklı sırada olabilir
✅ Property varlığı, tip ve içerik kontrolü
✅ Array'ler için sıra-bağımsız karşılaştırma

Fark Tipleri

Tip	Açıklama
`missing_key`	Anahtar file1'de var, file2'de yok
`extra_key`	Anahtar file2'de var, file1'de yok
`value_mismatch`	Değerler farklı
`type_mismatch`	Veri tipleri farklı

🧪 Test

Test Suite'i Çalıştır

bash

python test_compare.py

Test Senaryoları

Sıra-bağımsız test: Aynı içerik, farklı sıralama → identical
Farklılık tespiti: Farklı değerler → detaylı fark raporu
Kendisi ile: Aynı dosya → identical

Test Çıktısı

code

✅ Test 1 - Sıra-bağımsız: BAŞARILI
✅ Test 2 - Farklılık tespiti: BAŞARILI
✅ Test 3 - Aynı dosya: BAŞARILI

🔍 Test 2 Detayları:
   - Eksik anahtarlar: 1
   - Fazla anahtarlar: 2
   - Değer uyuşmazlıkları: 8
   - Tip uyuşmazlıkları: 0
   - Toplam fark: 11

🛠️ Geliştirme

Yeni Tool Eklemek

app.py dosyasına yeni fonksiyon ekle:

python

def myNewTool(param: str) -> str:
    # Your logic
    return result

server.py dosyasına MCP tool olarak kaydet:

python

@mcp.tool()
async def my_new_tool(param: str) -> str:
    """Tool açıklaması"""
    return myNewTool(param)

🚀 Deployment

Smithery Deployment

Repository'yi GitHub'a push et
Smithery'de repository'yi bağla
Tek tıkla deploy et! 🎉

Docker Deployment

bash

docker build -t json-compare-mcp .
docker run -p 8000:8000 json-compare-mcp

Manuel Deployment

bash

pip install -r requirements.txt
python server.py

📋 Gereksinimler

Python 3.11+
mcp
requests

🤝 Katkıda Bulunma

🍴 Fork et
🌱 Feature branch oluştur
💻 Değişiklikleri yap
🧪 Test et
📝 Pull request gönder

📄 Lisans

MIT License - Detaylar için LICENSE dosyasına bakın.

Made with ❤️ for better JSON comparison

Sıra-bağımsız, derinlemesine, güvenilir 🚀

ai.smithery/keremurat-json