ehliyet-digital

ehliyet.digital

トルコの運転免許試験に無料で備えるためのプラットフォームです。

MEB MTSK のカリキュラムに準拠した50件の授業ノート、80件の暗記用知識、過去の試験問題200問、実際の形式に沿った模擬試験を提供します。広告なしのオープンソースです。

🌐 サイト： ehliyet.digital 📄 LLM ディレクトリ： llms.txt · llms-full.txt 🔌 MCP： ehliyet-production.up.railway.app/mcp · MCP Market · Smithery · MCP Registry: io.github.merlhn/ehliyet-digital

---

内容

コンテンツ	件数	説明
授業ノート	43	4カテゴリの試験対策を目的とした解説
暗記用知識	80	暗記すべき一文のルール
原子的な要約	~560	各授業ページにある機械可読な知識項目
試験問題	200	4回分の模擬試験からの過去問題と解答
個別の問題ページ	186	各問題を専用URLで、解答と解説付きで掲載
個別の暗記用知識ページ	80	各知識を専用URLで、背景情報と関連する授業付きで掲載

授業カテゴリ

カテゴリ	トピック数	試験での出題数
応急処置	12	12問（%24）
交通と環境に関する知識	18	23問（%46）
車両技術（エンジン）	15	9問（%18）
交通マナー	5	6問（%12）

試験形式

• 50問、45分
• 正解1問につき2点。誤答による減点はありません
• 合格点：70点（正解35問以上）

---

API

すべてのデータにプログラムからアクセスできます。CORS は有効で、認証は不要です。

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"

エンドポイント：

エンドポイント	パラメーター	説明
/api/questions	section, count	ランダムな問題を返します
/api/quick-facts	section	暗記用知識
/api/mock-exam	—	50問の模擬試験
/api/lesson-summary	section, topic	授業の原子的な要約

section の値：ilk_yardim, trafik_ve_cevre, arac_teknigi, trafik_adabi, all

応答例

{
  "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 サーバー

AI エージェントは、Model Context Protocol を使って直接接続できます。

リモート（稼働中）：

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

Claude Desktop の設定：

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

ローカルでの実行：

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

ツール：

ツール	説明
get_practice_questions(section, count)	ランダムな問題を返します
get_quick_facts(section)	暗記用知識
generate_mock_exam()	50問の模擬試験
get_lesson_summary(section, topic)	授業の原子的な要約
explain_answer(question_id)	問題の解説と関連する授業

---

データファイル

機械可読な JSON 形式です。

ファイル	内容
mcp/data/questions.json	200問（4回分の試験）
mcp/data/quick-facts.json	暗記用知識80件
mcp/data/lesson-summaries.json	授業50件、原子的な知識~560件

---

技術

• フロントエンド： 静的 HTML/CSS/JS — ビルド手順不要、SSR
• ホスティング： Vercel（サイト）+ Railway（MCP）
• 認証： Firebase（Google OAuth）
• データベース： Firestore（ユーザープロフィールと試験結果のみ）
• アナリティクス： GA4（カスタムイベント：log_in（Google ログイン成功ごと；新規会員、ページ）、standart_sign_up（ログイン時、新規会員およびSınav 1のフロー以外）、sign_up_end_of_exam_no_1、exam_start / exam_complete（パネル）、start_exam_1 / exam_1_complete（ウェブ版Sınav 1）、exam_abandon、result_gate_view、banner_click、feedback_submit；試験イベントにはkaynak = web / panel が含まれます）

---

ローカルでの実行

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

---

プロジェクト構成

├── 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ı

---

コンテンツの出典

• MEB Motorlu Taşıt Sürücüleri Kursu（MTSK）のカリキュラム
• 道路交通法第2918号および関連規則
• Türkiye Kızılay Derneği の応急手当教育資料
• 実際の MTSK e試験で出題された問題

---

ライセンス

このプロジェクトはオープンソースとして公開されています。コンテンツは MEB MTSK のカリキュラムから編集されています。

---

お問い合わせ

• サイト： ehliyet.digital
• 概要： 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