MCP Ping Server & UI

Bu proje, Model Context Protocol (MCP) kullanarak web sitelerinin erişilebilirliğini test eden bir ping servisi ve kullanıcı dostu bir web arayüzü içerir.

📋 Proje Hakkında

Proje iki ana bileşenden oluşur:

• MCP Server (index.js): Web sitelerine ping gönderen MCP uyumlu bir sunucu
• Web UI (ping_app_ui.py): Gradio tabanlı kullanıcı arayüzü

🚀 Özellikler

• ✅ Web sitelerine ping gönderme
• ✅ MCP protokolü desteği
• ✅ Gradio tabanlı modern web arayüzü
• ✅ Ollama LLM entegrasyonu
• ✅ Gerçek zamanlı sonuç görüntüleme

📦 Kurulum

Gereksinimler

• Node.js (v14 veya üzeri)
• Python 3.8+
• Ollama (llama3.2 modeli)

Node.js Bağımlılıkları

npm install

Python Bağımlılıkları

pip install praisonaiagents gradio

Ollama Kurulumu

1. Ollama indirin ve kurun
2. Llama3.2 modelini indirin:

ollama pull llama3.2

🔧 Kullanım

MCP Server'ı Başlatma

node index.js

Web Arayüzünü Başlatma

python ping_app_ui.py

Web arayüzü varsayılan olarak http://localhost:7860 adresinde çalışacaktır.

📖 API Dokümantasyonu

MCP Tool: pingWebsite

Açıklama: Belirtilen URL'ye ping gönderir ve sonucu döndürür.

Parametreler:

• url (string): Test edilecek web sitesinin URL'si (geçerli URL formatında olmalı)

Örnek Kullanım:

{
  "url": "https://google.com"
}

Dönüş Değeri:

• Başarılı ping durumunda: Ping istatistikleri
• Hata durumunda: Hata mesajı

🖥️ Web Arayüzü Kullanımı

1. Web arayüzünü başlattıktan sonra tarayıcınızda açın
2. Metin kutusuna test etmek istediğiniz web sitesinin URL'sini girin
3. "Submit" butonuna tıklayın
4. Sonuçlar Markdown formatında görüntülenecektir

🏗️ Proje Yapısı

.
├── index.js              # MCP Server
├── ping_app_ui.py        # Gradio Web UI
├── package.json          # Node.js bağımlılıkları
├── package-lock.json     # Kilit dosyası
└── README.md             # Bu dosya

🔧 Teknik Detaylar

MCP Server (index.js)

• Framework: Model Context Protocol SDK
• Transport: StdioServerTransport
• Validasyon: Zod schema validation
• Ping Komutu: ping -c 2 <host> (2 paket gönderir)

Web UI (ping_app_ui.py)

• Framework: Gradio
• AI Agent: PraisonAI Agents
• LLM: Ollama Llama3.2
• MCP Integration: Node.js server ile entegrasyon

🛠️ Geliştirme

Yeni Özellik Ekleme

1. MCP server'a yeni tool eklemek için index.js dosyasını düzenleyin
2. Web arayüzünde değişiklik yapmak için ping_app_ui.py dosyasını güncelleyin

Test Etme

MCP server'ı test etmek için:

echo '{"method": "tools/call", "params": {"name": "pingWebsite", "arguments": {"url": "https://google.com"}}}' | node index.js

🐛 Sorun Giderme

Yaygın Sorunlar

1. "ping command not found": Sistem ping komutunun yüklü olduğundan emin olun
2. Ollama bağlantı hatası: Ollama servisinin çalıştığından ve llama3.2 modelinin yüklü olduğundan emin olun
3. Port çakışması: Gradio varsayılan portu değiştirmek için demo.launch(server_port=8080) kullanın

Log Kontrolü

MCP server loglarını görmek için:

DEBUG=* node index.js

📄 Lisans

ISC

🤝 Katkıda Bulunma

1. Bu repository'yi fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

📞 İletişim

Sorularınız için issue açabilir veya pull request gönderebilirsiniz.

---

Not: Bu proje eğitim ve demo amaçlı geliştirilmiştir. Üretim ortamında kullanmadan önce güvenlik ve performans testlerini yapmanız önerilir.