mcp-ping-app

cantrk21/mcp-ping-app

3.1

If you are the rightful owner of mcp-ping-app and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This project is a Model Context Protocol (MCP) based ping server and user-friendly web interface for testing website accessibility.

Tools
1
Resources
0
Prompts
0

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

  • Ollama indirin ve kurun
  • 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 -n 2 (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

mcp-ping-app