Skip to main content
Glama

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_listele

Kademeleri ve sınıf kimliklerini (sinif_id) listeler

ders_ara

Dersleri ada ve/veya kademeye göre arar, ders_slug döndürür

sinifa_gore_dersler

Bir kademe + sınıftaki dersleri, program PDF'leriyle listeler

ders_programi

Dersin program PDF'i, sınıf seviyeleri ve kitapları

uniteleri_listele

Bir ders + sınıfın ünite/temaları (unite_id)

unite_detay

Ünitenin tüm içeriği; isteğe bağlı bölüm filtresi

ogrenme_ciktilari

Bir sınıfın tüm ünitelerindeki öğrenme çıktıları ve ders saatleri

kitap_ara

Ders kitabı, öğretmen kılavuzu, çalışma ve etkinlik kitaplarında arama

kitap_detay

Kitabın PDF'i, etkileşimli kitap bağlantısı ve güncelleme tarihi

sayfalari_listele

Genel bilgi sayfalarını (beceri çerçeveleri, kılavuzlar…) listeler

sayfa_oku

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, .pth dosyalarına "gizli" bayrağı koyabiliyor ve Python 3.13+ gizli .pth dosyalarını atladığı için sunucu MCP istemcisinden başlatıldığında ModuleNotFoundError: tymm_mcp hatası 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 eder

Testler 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ı seed ile ç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 tools
ders_araA
Read-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_programiA
Read-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_listeleA
Read-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_araA
Read-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_detayB
Read-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_ciktilariA
Read-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_listeleA
Read-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_okuA
Read-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_derslerA
Read-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_detayB
Read-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_listeleA
Read-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

    A3.8/5.0

    Scored across 11 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      4
      74
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      27
      13
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      1
      MIT