English

Kandilli Deprem MCP Server

Kandilli Rasathanesi ve Deprem Araştırma Enstitüsü'nün (koeri.boun.edu.tr) canlı son-depremler listesini çekip MCP (Model Context Protocol) tool'ları olarak sunan minimal bir server. Claude Desktop, Claude Code veya herhangi bir MCP istemcisiyle (Open WebUI vb.) kullanılabilir.

Sunulan Tool'lar

Veri her çağrıda canlı olarak koeri.boun.edu.tr üzerinden çekilir (son 500 kayıt).

Telif: Veri Kandilli Rasathanesi'nin telif hakkı altındadır. Ticari kullanım için kaynağa başvurun.

1) stdio ile Kurulum ve Çalıştırma

stdio transport, Claude Desktop ve Claude Code gibi MCP istemcileri tarafından kullanılan varsayılan modudur; sunucuyu istemci kendisi başlatıp süreç (process) üzerinden konuşur.

Kurulum

git clone https://github.com/<kullanici-adi>/mcp-kandilli-deprem.git
cd mcp-kandilli-deprem
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Manuel Çalıştırma

python3 server.py

(TRANSPORT ortam değişkeni verilmezse varsayılan olarak stdio kullanılır.)

Claude Desktop / Claude Code Tool Direktifi

MCP istemcinizin config dosyasına (Claude Desktop için claude_desktop_config.json) aşağıdaki gibi ekleyin:

{
  "mcpServers": {
    "kandilli-deprem": {
      "command": "python3",
      "args": ["/tam/yol/mcp-kandilli-deprem/server.py"]
    }
  }
}

Sanal ortam (venv) kullanıyorsanız command alanına venv içindeki python'un tam yolunu verin, örn. /tam/yol/mcp-kandilli-deprem/.venv/bin/python3.

Config kaydedildikten sonra istemciyi yeniden başlatın; son_depremler, bolge_ara ve bolge_istatistik tool'ları otomatik olarak listelenecektir.

2) Docker ile Kurulum ve Çalıştırma

Docker modu, streamable-http transport üzerinden çalışır ve sunucuyu ağ üzerinden erişilebilir bir servis olarak ayağa kaldırır (ör. Open WebUI, uzak sunucu, birden çok istemci).

docker compose ile (önerilen)

docker compose up -d --build

Bu komut compose.yml içindeki ayarlarla (8811 portu, healthcheck, otomatik yeniden başlatma) servisi arka planda ayağa kaldırır. Loglara bakmak için:

docker compose logs -f

Durdurmak için:

docker compose down

Manuel Docker ile

docker build -t kandilli-deprem-mcp .
docker run -d \
  --name kandilli-deprem-mcp \
  -p 8811:8811 \
  -e TRANSPORT=streamable-http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=8811 \
  kandilli-deprem-mcp

Ortam Değişkenleri

Tool Direktifi (Streamable HTTP)

Docker'da çalışan sunucu, MCP endpoint'ini http://<host>:8811/mcp üzerinden sunar. Open WebUI veya Streamable HTTP destekleyen bir MCP istemcisinde bağlantıyı şu şekilde tanımlayın:

{
  "mcpServers": {
    "kandilli-deprem": {
      "url": "http://localhost:8811/mcp",
      "transport": "streamable-http"
    }
  }
}

Sunucunun ayakta olduğunu doğrulamak için:

docker compose ps

healthy durumu, servisin 8811 portunda dinlediğini gösterir.

Gereksinimler

• Python 3.12+

• mcp SDK (bkz. requirements.txt)

Lisans

Bu projenin kaynak kodu MIT Lisansı ile lisanslanmıştır. Deprem verisi ise Kandilli Rasathanesi'ne aittir ve ilgili kullanım koşullarına tabidir (kod lisansından bağımsızdır).