tymm-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tymm-mcp 9. sınıf kimya dersinin öğrenme çıktılarını ve ders saatlerini listele"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tymm-mcp
Türkiye Yüzyılı Maarif Modeli (MEB) sitesi için bir MCP sunucusu. Claude ve diğer MCP istemcileri bu sunucuyla öğretim programlarını, ünite/tema içeriklerini (öğrenme çıktıları, beceriler, ders saatleri) ve ders kitaplarını doğrudan sorgulayabilir.
Resmî bir MEB ürünü değildir. Veriler her istekte sitenin herkese açık sayfalarından okunur ve 1 saat boyunca bellekte önbelleğe alınır.
Araçlar
Araç | Ne yapar |
| Kademeleri ve sınıf kimliklerini ( |
| Dersleri ada ve/veya kademeye göre arar, |
| Bir kademe + sınıftaki dersleri, program PDF'leriyle listeler |
| Dersin program PDF'i, sınıf seviyeleri ve kitapları |
| Bir ders + sınıfın ünite/temaları ( |
| Ünitenin tüm içeriği; isteğe bağlı bölüm filtresi |
| Bir sınıfın tüm ünitelerindeki öğrenme çıktıları ve ders saatleri |
| Ders kitabı, öğretmen kılavuzu, çalışma ve etkinlik kitaplarında arama |
| Kitabın PDF'i, etkileşimli kitap bağlantısı ve güncelleme tarihi |
| Genel bilgi sayfalarını (beceri çerçeveleri, kılavuzlar…) listeler |
| tymm.meb.gov.tr üzerindeki herhangi bir sayfayı metin olarak okur |
Örnek istemler:
"9. sınıf kimya dersinin tüm öğrenme çıktılarını ve ders saatlerini çıkar."
"5. sınıf fen bilimleri 2. ünitenin anahtar kavramlarını ve ölçme-değerlendirme kısmını getir."
"10. sınıf matematik öğretmen kılavuz kitabının PDF bağlantısı nedir?"
"KB2.4 çözümleme becerisi nasıl tanımlanıyor?"
Related MCP server: Skolverket MCP Server
Kurulum
Python 3.10 veya üzeri gerekir.
cd tymm-mcp
python3 -m venv .venv
.venv/bin/pip install .Kodda değişiklik yaptıktan sonra
.venv/bin/pip install .komutunu tekrar çalıştırın. Düzenlenebilir kurulum (pip install -e .) macOS'ta önerilmez: macOS,.pthdosyalarına "gizli" bayrağı koyabiliyor ve Python 3.13+ gizli.pthdosyalarını atladığı için sunucu MCP istemcisinden başlatıldığındaModuleNotFoundError: tymm_mcphatası verir.
Claude Code
claude mcp add tymm -- "$(pwd)/.venv/bin/tymm-mcp"Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin (yolu kendi klasörünüzle değiştirin):
{
"mcpServers": {
"tymm": {
"command": "/TAM/YOL/tymm-mcp/.venv/bin/tymm-mcp"
}
}
}Test
.venv/bin/python tests/smoke.py # araç fonksiyonlarını doğrudan çağırır
.venv/bin/python tests/stdio_e2e.py # sunucuyu MCP stdio üzerinden başlatıp test ederTestler canlı siteye istek atar.
Nasıl çalışır
Site ASP.NET MVC ile sunucu tarafında üretiliyor. Bu sunucu iki kaynaktan okur:
JSON uç noktaları (sitenin kendi filtre menülerinin kullandığı):
/Ders/GetProgramList,/Ders/GetDerslerBySinif,/Kitap/GetDersKitaplariList. Listeler 20'şerli sayfalanıyor; tüm sayfalar aynıseedile çekilir.HTML sayfaları: ders (
/ogretim-programlari/ders/{slug}), sınıf (/ogretim-programlari/{slug}/{sinif_id}), ünite (/{slug}/unite/{unite_id}) ve kitap (/kitap/{id}/{slug}) sayfaları BeautifulSoup ile ayrıştırılır.
Site yapısı değişirse ayrıştırıcılar src/tymm_mcp/client.py içinde. Siteye aynı anda en fazla 4 istek gider; robots.txt yalnızca /admin yolunu engelliyor ve bu yol okunmaz.
Lisans
MIT. Lisans yalnızca bu sunucunun kodunu kapsar; tymm.meb.gov.tr üzerindeki içeriklerin hakları MEB'e aittir.
Available Tools
11 toolsders_araARead-onlyIdempotent
Öğretim programı bulunan dersleri ada ve/veya kademeye göre arar.
Dönen ders_slug değeri ders_programi, uniteleri_listele ve ogrenme_ciktilari araçlarında kullanılır.
Inputs: sorgu, kademe. Returns: result
ders_programiARead-onlyIdempotent
Bir dersin öğretim programı sayfasını getirir: program PDF'i, sınıf seviyeleri (sinif_id) ve derse ait kitaplar.
Inputs: ders (required). Returns: result
kademeleri_listeleARead-onlyIdempotent
Okul türlerini/kademeleri ve her kademedeki sınıf seviyelerini kimlikleriyle listeler.
Sınıf kimlikleri (sinif_id) diğer araçlarda kullanılır. Örn. 9.Sınıf = 11, 12.Sınıf = 14.
Inputs: no named parameters. Returns: result
kitap_araARead-onlyIdempotent
Ders kitapları, öğretmen kılavuz kitapları, çalışma kitapları ve etkinlik kitapları arasında arama yapar.
Her sonuç için PDF ve (varsa) etkileşimli kitap bağlantısı döner.
Inputs: limit, sorgu, kademe, ders_id, +1 more. Returns: result
kitap_detayBRead-onlyIdempotent
Bir kitabın ayrıntılarını getirir: sınıf/ders/kademe etiketleri, güncelleme tarihi, PDF ve etkileşimli kitap bağlantısı.
Inputs: kitap_id (required). Returns: result
ogrenme_ciktilariARead-onlyIdempotent
Bir dersin bir sınıf seviyesindeki TÜM ünitelerinin öğrenme çıktılarını ve ders saatlerini tek seferde getirir.
Yıllık plan, kazanım listesi ya da ölçme aracı hazırlarken kullanışlıdır.
Inputs: ders (required), sinif_id (required). Returns: result
sayfalari_listeleARead-onlyIdempotent
Sitedeki genel bilgi sayfalarını (model, beceri çerçeveleri, planlar, kılavuzlar, materyaller) yollarıyla listeler.
Bir sayfanın içeriği için sayfa_oku aracını kullanın.
Inputs: no named parameters. Returns: result
sayfa_okuARead-onlyIdempotent
tymm.meb.gov.tr üzerindeki herhangi bir sayfanın ana içeriğini düz metin/Markdown olarak okur.
Beceri tanımları (KB, E, SDB, OB, D kodları), model açıklamaları, kılavuz ve materyal listeleri için kullanılır.
Inputs: yol (required), baslangic, max_karakter. Returns: result
sinifa_gore_derslerARead-onlyIdempotent
Belirli bir kademe ve sınıf seviyesinde öğretim programı olan dersleri, program PDF bağlantılarıyla listeler.
Inputs: kademe (required), sinif_id (required). Returns: result
unite_detayBRead-onlyIdempotent
Bir ünite/temanın tüm program içeriğini getirir.
İçerik: ders saati, alan/kavramsal beceriler, eğilimler, programlar arası bileşenler (SDB, değerler, okuryazarlık), öğrenme çıktıları ve süreç bileşenleri, içerik çerçevesi, anahtar kavramlar, ölçme-değerlendirme, öğrenme-öğretme uygulamaları, zenginleştirme ve destekleme.
Inputs: ders (required), unite_id (required), bolumler. Returns: result
uniteleri_listeleARead-onlyIdempotent
Bir dersin belirli sınıf seviyesindeki ünite/temalarını unite_id değerleriyle listeler.
Inputs: ders (required), sinif_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools target distinct resource+action pairs (list units vs. unit detail, search books vs. book detail, list pages vs. read page). However, ders_programi, sinifa_gore_dersler, and ders_ara all revolve around finding course curricula and their boundaries are only moderately clarified by the descriptions, and sayfa_oku's generic 'read any page' scope overlaps conceptually with every other fetch tool.
A predictable Turkish noun+suffix pattern dominates: *(_listele), *(_ara), *(_detay), *(_oku), which makes intent recognizable at a glance. Deviations exist (sinifa_gore_dersler uses a prepositional phrase; ders_programi and ogrenme_ciktilari are bare nouns with no action verb), but the set remains readable and consistent overall.
Eleven tools is well within the ideal range and each one maps to a concrete step in the curriculum-exploration workflow (levels → courses → units → unit content → outcomes; books/pages as parallel branches). No tool looks redundant or like padding.
As a read-only curriculum domain, the surface is nearly complete: ID resolution (kademeleri_listele), discovery (ders_ara, kitap_ara, sayfalari_listele), and deep retrieval (ders_programi, unite_detay, ogrenme_ciktilari, kitap_detay, sayfa_oku) are all present. Minor gaps remain—no cross-resource or keyword search over unit contents/outcomes, and no dedicated way to retrieve assessment materials as a separate collection.
Maintenance
Related MCP Connectors
Web search, scraping, RAG answers with citations, and translation as MCP tools.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides an MCP interface for accessing YOKATLAS (Turkish Higher Education Council Atlas) data, enabling LLM applications like Claude to search and retrieve details about undergraduate and associate degree programs in Turkey.474MIT
- AlicenseAqualityDmaintenanceEnables LLMs to access Swedish educational data through Skolverket's open APIs, allowing users to search curricula, courses, schools, adult education programs, and analyze educational requirements and standards. Provides comprehensive tools for teachers, students, guidance counselors, and educational researchers to interact with official Swedish education data.2713MIT
- AlicenseNot gradedqualityDmaintenanceProvides programmatic access to Turkey's Ministry of Justice Legislation Information System (mevzuat.gov.tr), enabling users to search legislation, retrieve article hierarchies, and fetch article contents in Markdown format through natural language.1MIT
- AlicenseNot gradedqualityCmaintenanceExposes Marble's open skill taxonomy (ages 4-15) as queryable MCP tools, enabling AI agents to search topics, find prerequisites, and plan learning paths.1MIT