Ehliyet Digital

What ehliyet-digital MCP server does

The ehliyet-digital MCP server exposes structured preparation material for Türkiye’s driving-license theory exam. Its source content follows the MEB MTSK curriculum and covers four areas: first aid, traffic and environmental knowledge, vehicle technology, and traffic etiquette.

The repository includes 200 exam questions, 80 short memorization facts, and 43 lesson summaries containing roughly 560 machine-readable information units. Questions include answer choices, the correct answer, exam and section metadata, and an indicator for whether an image is present. The content is intended for study assistance rather than for operating a vehicle or replacing official guidance.

How it works

AI clients communicate with the server through Model Context Protocol. The hosted endpoint uses streamable HTTP at https://ehliyet-production.up.railway.app/mcp; an older SSE endpoint is also available at /sse. A local Python process can communicate over stdio, or run in HTTP/SSE mode for remote agents.

The ehliyet-digital MCP server reads its packaged JSON data for questions, quick facts, and lesson summaries. Question retrieval supports a section and requested count, while lesson lookup accepts both a section and topic. The mock-exam tool creates a 50-question practice test based on the real exam distribution. Answer explanations use a question ID and return the explanation together with related lessons.

The underlying website also exposes unauthenticated REST endpoints with open CORS, but MCP clients normally use the MCP endpoint and its tools instead. The hosted service is separate from the static website and is deployed on Railway, while the website and REST API are hosted on Vercel.

Setup and configuration

For a hosted connection, configure an MCP client with the streamable HTTP URL. A Claude Desktop configuration uses an MCP server entry with type set to http and the endpoint as its url.

For local use, change into the repository’s mcp directory, install the packages listed in requirements.txt, and run python server.py. This starts stdio mode for clients such as Claude Desktop or Claude Code. Running python server.py --http starts the HTTP/SSE mode instead.

Tools and capabilities

Available MCP tools are:

• get_practice_questions(section, count): returns random practice questions.
• get_quick_facts(section): retrieves short facts for a section.
• generate_mock_exam(): produces a 50-question mock exam.
• get_lesson_summary(section, topic): returns an atomic lesson summary.
• explain_answer(question_id): provides an answer explanation and related lessons.

Supported section values are ilk_yardim, trafik_ve_cevre, arac_teknigi, trafik_adabi, and all where applicable.

Limitations and notes

The content is specific to the Turkish driving-license theory exam and is written around the listed MTSK sources, including traffic law, first-aid material, and previously used MTSK exam questions. The repository describes the project as open source but does not state a specific license name. The hosted MCP endpoint is presented without authentication, so deployments that need access control should account for that separately.