🔍 JSON Compare MCP Server
✨ Ö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
git clone https://github.com/yourusername/json-compare-mcp.git
cd json-compare-mcp
pip install -r requirements.txt
2. MCP Server'ı Başlat
3. Test Et
📦 Ne İçeriyor?
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
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!
{
"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
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ı
✅ 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
app.py dosyasına yeni fonksiyon ekle:
def myNewTool(param: str) -> str:
return result
server.py dosyasına MCP tool olarak kaydet:
@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
docker build -t json-compare-mcp .
docker run -p 8000:8000 json-compare-mcp
Manuel Deployment
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 🚀
