mcp server

ehliyet

Türkiye ehliyet sınavına ücretsiz hazırlık: 43 ders notu, 76 hap bilgi, 200 soru, REST API ve MCP sunucusu. Açık kaynak.

merlhn/ehliyetcommunitylistedunreviewednot running here yet

Use tool

Set up

Hosted by its author. Add the URL to your agent — nothing to install.

~/Library/Application Support/Claude/claude_desktop_config.json

Settings → Connectors → Add custom connector

Name: ehliyet
URL:  https://ehliyet-production.up.railway.app/mcp

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

ehliyet.digital

Türkiye ehliyet (sürücü belgesi) sınavına ücretsiz hazırlık platformu.

MEB MTSK müfredatına uygun 43 ders notu, 80 hap bilgi, 200 çıkmış sınav sorusu ve gerçek formatta deneme sınavları. Reklamsız, açık kaynak.

🌐 Site: ehliyet.digital 📄 LLM dizini: llms.txt · llms-full.txt 🔌 MCP: ehliyet-production.up.railway.app/mcp · MCP Market · Smithery · MCP Registry: io.github.merlhn/ehliyet-digital

Ne içerir?

İçerik	Adet	Açıklama
Ders notları	43	4 kategoride sınav odaklı konu anlatımı
Hap bilgiler	80	Tek cümlelik ezberlenecek kurallar
Atomik özetler	~560	Her ders sayfasında makine-okunur bilgi satırları
Sınav soruları	200	4 deneme sınavından çıkmış sorular + cevaplar
Bireysel soru sayfaları	186	Her soru kendi URL'inde, cevap + açıklama ile
Bireysel hap bilgi sayfaları	80	Her hap bilgi kendi URL'inde, bağlam + ilgili ders ile

Ders kategorileri

Kategori	Konu sayısı	Sınav dağılımı
İlk Yardım	12	12 soru (%24)
Trafik ve Çevre Bilgisi	11	23 soru (%46)
Araç Tekniği (Motor)	15	9 soru (%18)
Trafik Adabı	5	6 soru (%12)

Sınav formatı

50 soru, 45 dakika
Her doğru cevap 2 puan, yanlış doğruyu götürmez
Geçme notu: 70 puan (en az 35 doğru)

API

Tüm verilere programatik erişim — CORS açık, kimlik doğrulama yok.

REST API (Vercel)

# 5 rastgele İlk Yardım sorusu
curl "https://ehliyet.digital/api/questions?section=ilk_yardim&count=5"

# Trafik ve Çevre hap bilgileri
curl "https://ehliyet.digital/api/quick-facts?section=trafik_ve_cevre"

# 50 soruluk deneme sınavı (gerçek dağılımla)
curl "https://ehliyet.digital/api/mock-exam"

# Fren sistemi ders özeti
curl "https://ehliyet.digital/api/lesson-summary?section=arac_teknigi&topic=fren"

Endpoint'ler:

Endpoint	Parametreler	Açıklama
`/api/questions`	`section`, `count`	Rastgele soru döner
`/api/quick-facts`	`section`	Hap bilgiler
`/api/mock-exam`	—	50 soruluk tam deneme
`/api/lesson-summary`	`section`, `topic`	Ders atomik özeti

section değerleri: ilk_yardim, trafik_ve_cevre, arac_teknigi, trafik_adabi, all

Örnek yanıt

{
  "count": 1,
  "section": "ilk_yardim",
  "source": "ehliyet.digital",
  "questions": [
    {
      "id": "sinav1-q02",
      "exam": "Sınav 1",
      "section": "İlk Yardım",
      "stem": "Yetişkinlerde temel yaşam desteği ile ilgili uygulamalardan hangisi doğrudur?",
      "options": [
        "A) Göğüs kemiği 3 cm aşağı inecek şekilde bası yapılması",
        "B) Temel yaşam desteğine yapay solunum ile başlanması",
        "C) 30 kalp masajı, 2 yapay solunum şeklinde uygulanması",
        "D) Kalp masajı hızının dakikada 30 bası olacak şekilde ayarlanması"
      ],
      "correct_index": 2,
      "correct_letter": "C",
      "correct_text": "30 kalp masajı, 2 yapay solunum şeklinde uygulanması",
      "has_image": false
    }
  ]
}

MCP Sunucusu

AI agent'lar Model Context Protocol ile doğrudan bağlanabilir.

Remote (canlı):

Streamable HTTP: https://ehliyet-production.up.railway.app/mcp   (önerilen)
SSE (eski):      https://ehliyet-production.up.railway.app/sse

Claude Desktop yapılandırması:

{
  "mcpServers": {
    "ehliyet-digital": {
      "type": "http",
      "url": "https://ehliyet-production.up.railway.app/mcp"
    }
  }
}

Lokal çalıştırma:

cd mcp
pip install -r requirements.txt
python server.py          # stdio (Claude Desktop/Code)
python server.py --http   # HTTP/SSE (remote agent'lar)

Araçlar:

Araç	Açıklama
`get_practice_questions(section, count)`	Rastgele soru döner
`get_quick_facts(section)`	Hap bilgiler
`generate_mock_exam()`	50 soruluk deneme sınavı
`get_lesson_summary(section, topic)`	Ders atomik özeti
`explain_answer(question_id)`	Soru açıklaması + ilgili dersler

Veri dosyaları

Makine-okunur JSON formatında:

Dosya	İçerik
`mcp/data/questions.json`	200 soru (4 sınav)
`mcp/data/quick-facts.json`	80 hap bilgi
`mcp/data/lesson-summaries.json`	43 ders, ~560 atomik bilgi

Teknoloji

Frontend: Statik HTML/CSS/JS — build adımı yok, SSR
Hosting: Vercel (site) + Railway (MCP)
Auth: Firebase (Google OAuth)
Veritabanı: Firestore (yalnızca kullanıcı profili ve sınav sonuçları)
Analytics: GA4 (custom event'ler: log_in (her başarılı Google girişi; yeni_uye, sayfa), standart_sign_up, sign_up_end_of_exam_no_1, exam_start / exam_complete (panel), start_exam_1 / exam_1_complete (web Sınav 1), exam_abandon, result_gate_view, banner_click, feedback_submit; sınav event'leri kaynak = web / panel taşır)

Yerelde çalıştırma

python3 -m http.server 8000
# http://localhost:8000

Proje yapısı

├── index.html                  Ana sayfa
├── dersler/                    43 ders notu (4 kategori)
├── hap-bilgiler/               80 hap bilgi (4 kategori)
├── ehliyet-sinav-sorulari/     20 örnek soru + 186 sorunun dizini; alt dizinler: konu bazlı soru sayfaları
├── deneme-sinavi/              Herkese açık deneme sınavı (yalnız Sınav 1, giriş gerekmez)
├── ehliyet-fiyatlari/                   2026 ehliyet fiyatları (harç, sınav, kurs)
├── soru/                       186 bireysel soru sayfası
├── panel/                      Giriş gerektiren alan (sınavlar)
├── api/                        REST API (Vercel serverless)
├── mcp/                        MCP sunucusu + veri dosyaları
├── assets/js/questions-*.js    Soru bankaları (4 sınav)
├── tools/                      Üretici scriptler
│   ├── schema-uret.py          JSON-LD yapısal veri
│   ├── sitemap-uret.py         sitemap.xml
│   ├── llms-uret.py            llms-full.txt
│   ├── feed-uret.py            RSS feed + discovery link
│   ├── soru-sayfa-uret.py      Bireysel soru sayfaları
│   ├── hap-sayfa-uret.py       Bireysel hap bilgi sayfaları
│   ├── konu-deneme-uret.py     Panel konu denemesi sayfası
│   ├── banner-ekle.py          Header üstü deneme sınavı banner'ı (zincirin en sonunda çalışır)
│   ├── atomik-ekle.py          Ders atomik özetleri
│   ├── cevap-ac.py             Soru cevaplarını HTML'e taşı
│   ├── indexnow.py             Değişen sayfaları Bing/IndexNow'a bildir
│   └── mcp-veri-uret.py        MCP JSON veri dosyaları
├── llms.txt                    AI/LLM site dizini
├── llms-full.txt               Detaylı içerik dizini
├── feed.xml                    RSS feed
├── sitemap.xml                 251 URL
├── robots.txt                  AI tarayıcıları açık
└── 404.html                    Özel hata sayfası

İçerik kaynakları

MEB Motorlu Taşıt Sürücüleri Kursu (MTSK) müfredatı
2918 sayılı Karayolları Trafik Kanunu ve ilgili yönetmelikler
Türkiye Kızılay Derneği ilk yardım eğitim materyalleri
Gerçek MTSK e-sınavlarında çıkmış sorular

Lisans

Bu proje açık kaynak olarak yayınlanmıştır. İçerikler MEB MTSK müfredatından derlenmiştir.

İletişim

Site: ehliyet.digital
Hakkında: ehliyet.digital/hakkinda
GitHub: github.com/merlhn/ehliyet
MCP Market: mcpmarket.com/server/ehliyet-digital
Smithery: smithery.ai/servers/omerlhn/ehliyet-digital
MCP Registry: io.github.merlhn/ehliyet-digital