Ehliyet Digital

io.github.merlhnPublished by GitHub account merlhnv1.1.0Updated Oct 24, 2026

Türkiye ehliyet sınavı hazırlık: 200 çıkmış soru, 76 hap bilgi, 43 ders özeti, deneme sınavı.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

Turkish driving-licence exam prep server: lets an assistant pull practice questions, quick facts, lesson summaries and full mock exams.

What you can do
  • Fetch random practice questions by section and count
  • Retrieve memorizable quick facts per section
  • Generate a full 50-question mock exam in the real distribution
  • Get atomic lesson summaries by section and topic
  • Explain a question's answer with related lessons
When to use it
Useful when someone is preparing for the Turkish MEB MTSK driving-licence theory exam and wants an assistant to quiz them, drill quick facts, or explain answers and lesson topics in Turkish.
Requirements
Remote Streamable HTTP endpoint at ehliyet-production.up.railway.app/mcp (an older SSE endpoint also exists); no authentication or API keys. Optional local run needs Python with the listed requirements installed.
Before you install
Content is Turkish-language exam material compiled from MEB MTSK curriculum and past e-exams; it is study aid, not official exam material. The tools are read-only lookups, but the site's own API is open with CORS enabled and no authentication.

Installation

In SourceWeft

  1. Open Ehliyet Digital in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.merlhn%2Fehliyet-digital/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

ehliyet.digital

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

MEB MTSK müfredatına uygun 50 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?

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

Ders kategorileri

KategoriKonu sayısıSınav dağılımı
İlk Yardım1212 soru (%24)
Trafik ve Çevre Bilgisi1823 soru (%46)
Araç Tekniği (Motor)159 soru (%18)
Trafik Adabı56 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)

bash
# 5 rastgele İlk Yardım sorusucurl "https://ehliyet.digital/api/questions?section=ilk_yardim&count=5"
# Trafik ve Çevre hap bilgilericurl "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 özeticurl "https://ehliyet.digital/api/lesson-summary?section=arac_teknigi&topic=fren"

Endpoint'ler:

EndpointParametrelerAçıklama
/api/questionssection, countRastgele soru döner
/api/quick-factssectionHap bilgiler
/api/mock-exam—50 soruluk tam deneme
/api/lesson-summarysection, topicDers atomik özeti

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

Örnek yanıt

json
{  "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ı:

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

Lokal çalıştırma:

bash
cd mcppip install -r requirements.txtpython 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.json200 soru (4 sınav)
mcp/data/quick-facts.json80 hap bilgi
mcp/data/lesson-summaries.json50 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 (girişte, yeni üye ve Sınav 1 akışı dışında), 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

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

Proje yapısı

├── index.html                  Ana sayfa├── dersler/                    50 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ı│   ├── konu-listesi-uret.py    Konu listeleri ve ders özetleri (sınav konuları, ders hub'ları; lessons-nav.js'ten)│   ├── yil-guncelle.py         1 Ocak'ta başlıklardaki yılı yeniler (ücret sayfaları --veri ile)│   ├── 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

Source: README.md at commit f5a4410

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts