ehliyet-digital

ehliyet.digital

Türkiye 驾照（驾驶证）考试免费备考平台。

符合 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 分钟
• 每道答对的题得 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 Agent 可以通过 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 登录；新会员、页面）、standard_sign_up（登录时触发，不包括新会员和考试 1 流程）、sign_up_end_of_exam_no_1、exam_start / exam_complete（面板）、start_exam_1 / exam_1_complete（网站考试 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 号《道路交通法》及相关法规
• 土耳其红新月会急救培训资料
• 真实 MTSK 电子考试中的历年试题

---

许可证

本项目以开源形式发布。内容根据 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