Skip to content
Back to search

yoktez-mcp

MCP Server for Turkish Thesis Database

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/saidsurucu--yoktez-mcp/badge.svg)](/listings/saidsurucu--yoktez-mcp)

HTML

<a href="/listings/saidsurucu--yoktez-mcp"><img src="/api/listings/saidsurucu--yoktez-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 154 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # YokTez MCP: YÖK Ulusal Tez Merkezi için MCP Sunucusu
  2. Bu proje, Yükseköğretim Kurulu (YÖK) Ulusal Tez Merkezi'ne erişimi kolaylaştıran bir [FastMCP](https://gofastmcp.com/) sunucusu oluşturur. Bu sayede, YÖK Tez Merkezi'nden tez arama ve tezlerin PDF içeriklerini Markdown formatında getirme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya [5ire](https://5ire.app)) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.
  3. ![YÖK Tez MCP Örneği](./ornek.png)
  4. 🎯 **Temel Özellikler**
  5. * YÖK Ulusal Tez Merkezi'ne programatik erişim için standart bir MCP arayüzü.
  6. * Aşağıdaki yetenekler:
  7. * **Detaylı Tez Arama:** Başlık, yazar, danışman, üniversite, enstitü, anabilim/bilim dalı, tez türü, yıl aralığı, izin durumu, tez numarası, konu, dizin ve özet metni gibi çeşitli kriterlere göre tez arama.
  8. * **Tez Belgesi Getirme:** Belirli bir tezin PDF içeriğini, PDF sayfa bazında, işlenmiş Markdown formatında getirme.
  9. * **Metadata Çıkarımı:** Tez detay sayfalarından başlık, yazar, yıl, özet gibi önemli üst verilerin çıkarılması.
  10. * **PDF İzin Kontrolü:** Erişilemeyen veya yayın izni olmayan tezler için uygun bildirim.
  11. * Karar metinlerinin LLM'ler tarafından daha kolay işlenebilmesi için Markdown formatına çevrilmesi.
  12. * Claude Desktop uygulaması ile `fastmcp install` komutu (veya manuel yapılandırma) kullanılarak kolay entegrasyon.
  13. * YokTez MCP [5ire](https://5ire.app) gibi Claude Desktop haricindeki MCP istemcilerini de destekler.
  14. ---
  15. ## 🚀 5 Dakikada Başla (Remote MCP)
  16. ### ✅ Kurulum Gerektirmez! Hemen Kullan!
  17. 🔗 **Remote MCP Adresi:** `https://yoktezmcp.fastmcp.app/mcp`
  18. ### Claude Desktop ile Kullanım
  19. 1. **Claude Desktop'ı açın**
  20. 2. **Settings → Connectors → Add Custom Connector**
  21. 3. **Bilgileri girin:**
  22. - **Name:** `YokTez MCP`
  23. - **URL:** `https://yoktezmcp.fastmcp.app/mcp`
  24. 4. **Add** butonuna tıklayın
  25. 5. **Hemen kullanmaya başlayın!** 🎉
  26. ### Google Antigravity ile Kullanım
  27. 1. **Agent session** açın ve editörün yan panelindeki **"…"** dropdown menüsüne tıklayın
  28. 2. **MCP Servers** seçeneğini seçin - MCP Store açılacak
  29. 3. Üstteki **Manage MCP Servers** butonuna tıklayın
  30. 4. **View raw config** seçeneğine tıklayın
  31. 5. `mcp_config.json` dosyasına aşağıdaki yapılandırmayı ekleyin:
  32. ```json
  33. {
  34. "mcpServers": {
  35. "yoktez-mcp": {
  36. "serverUrl": "https://yoktezmcp.fastmcp.app/mcp/",
  37. "headers": {
  38. "Content-Type": "application/json"
  39. }
  40. }
  41. }
  42. }
  43. ```
  44. > 💡 **İpucu:** Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Claude Desktop üzerinden YÖK Ulusal Tez Merkezi'ne erişebilirsiniz!
  45. ---
  46. 🚀 **Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)**
  47. Bu bölüm, YokTez MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.
  48. * **Python Kurulumu:** Sisteminizde Python 3.11 kurulu olmalıdır. Kurulum sırasında "**Add Python to PATH**" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. [Buradan](https://www.python.org/downloads/) 3.11 sürümünü indirebilirsiniz.
  49. * **Git Kurulumu (Windows):** Bilgisayarınıza [git](https://git-scm.com/downloads/win) yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
  50. * **`uv` Kurulumu:**
  51. * **Windows Kullanıcıları (PowerShell):** Bir CMD ekranı açın ve bu kodu çalıştırın: `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`
  52. * **Mac/Linux Kullanıcıları (Terminal):** Bir Terminal ekranı açın ve bu kodu çalıştırın: `curl -LsSf https://astral.sh/uv/install.sh | sh`
  53. * **Microsoft Visual C++ Redistributable (Windows):** Bazı Python paketlerinin doğru çalışması için gereklidir. [Buradan](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) indirip kurun.
  54. * İşletim sisteminize uygun [5ire](https://5ire.app) MCP istemcisini indirip kurun.
  55. * 5ire'ı açın. **Workspace -> Providers** menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
  56. * **Tools** menüsüne girin. **+Local** veya **New** yazan butona basın.
  57. * **Tool Key:** `yoktezmcp`
  58. * **Name:** `YokTez MCP`
  59. * **Command:**
  60. ```
  61. uvx --from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp
  62. ```
  63. * **Save** butonuna basarak kaydedin.
  64. ![5ire YokTez MCP Ayarları](./5ire-settings.png)
  65. * Şimdi **Tools** altında **YokTez MCP**'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
  66. * Artık YokTez MCP ile konuşabilirsiniz.
  67. ---
  68. ⚙️ **Claude Desktop Manuel Kurulumu**
  69. 1. **Ön Gereksinimler:** Python, `uv`, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.
  70. 2. Claude Desktop **Settings -> Developer -> Edit Config**.
  71. 3. Açılan `claude_desktop_config.json` dosyasına `mcpServers` altına ekleyin:
  72. ```json
  73. {
  74. "mcpServers": {
  75. // ... (varsa diğer sunucularınız) ...
  76. "YokTez MCP": {
  77. "command": "uvx",
  78. "args": [
  79. "--from", "git+https://github.com/saidsurucu/yoktez-mcp",
  80. "yoktez-mcp"
  81. ]
  82. }
  83. }
  84. }
  85. ```
  86. 4. Claude Desktop'ı kapatıp yeniden başlatın.
  87. ---
  88. 🧩 **MCP Yerine Skill Olarak Kullanım (Claude in Chrome / Claude Desktop tarayıcısı)**
  89. Sunucu kurmak istemeyenler için aynı yetenekler [`skills/yoktez`](./skills/yoktez) klasöründe bir Claude **skill**'i olarak da var. Skill, tarayıcıda açık bir `tez.yok.gov.tr` sekmesine JavaScript enjekte ederek çalışır; Python, `uv` ya da MCP sunucusu gerekmez. YÖK'te CAPTCHA veya giriş zorunluluğu olmadığından hem Claude in Chrome eklentisiyle hem de Claude Desktop'ın yerleşik tarayıcısıyla çalışır.
  90. Skill'in yapabildikleri:
  91. * Anahtar kelimeyle arama (tez adı / yazar / danışman / konu / anahtar kelime / özet; en fazla 3 terim, ve/veya)
  92. * Detaylı arama: Anabilim Dalı kodları (birden fazlası birleştirilir), tez adı, yazar, danışman, anahtar kelime, özet, **tez numarası**, tür, dil, yıl, izin durumu
  93. * Anabilim Dalı adından kod bulma, son eklenen tezler
  94. * Danışman, Türkçe/İngilizce özet, anahtar kelimeler ve hazır atıflar (APA, IEEE, MLA, Chicago, Harvard)
  95. * Tez PDF'ini sayfa aralığıyla metin olarak okuma (yazarın kısıtladığı tezlerde kısıtlama gerekçesini bildirir)
  96. **Kurulum (Claude Code):**
  97. ```bash
  98. git clone https://github.com/saidsurucu/yoktez-mcp && cp -r yoktez-mcp/skills/yoktez ~/.claude/skills/
  99. ```
  100. **Kurulum (Claude Desktop / claude.ai):** `skills/yoktez` klasörünü zip'leyip **Settings → Capabilities → Skills** bölümünden yükleyin.
  101. Ayrıntılar için [`skills/yoktez/SKILL.md`](./skills/yoktez/SKILL.md) ve [`skills/yoktez/reference.md`](./skills/yoktez/reference.md) dosyalarına bakın.
  102. ---
  103. 🛠️ **Kullanılabilir Araçlar (MCP Tools)**
  104. Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:
  105. * **`search_yok_tez_detailed`**: YÖK Ulusal Tez Merkezi'nde çeşitli detaylı kriterleri kullanarak tez araması yapar.
  106. * **Parametreler**: `thesis_title`, `author_name`, `advisor_name`, `university_name`, `institute_name`, `department_name`, `discipline_name`, `thesis_number`, `subject_headings`, `index_terms`, `abstract_text`, `thesis_type`, `permission_status`, `thesis_status`, `language`, `institute_group`, `year_start`, `year_end`, `page`, `results_per_page`.
  107. * **Döndürdüğü Değer**: `YokTezSearchResult` (sayfalanmış tez özeti listesi, toplam sonuç sayısı vb. içerir)
  108. * **`get_yok_tez_document_markdown`**: Belirli bir YÖK tezinin PDF içeriğini, istenen PDF sayfasına göre Markdown formatında getirir.
  109. * **Parametreler**: `detail_page_url` (tez detay sayfası URL'si), `page_number` (istenen PDF sayfa numarası).
  110. * **Döndürdüğü Değer**: `YokTezDocumentMarkdown` (sayfanın Markdown içeriği, toplam sayfa sayısı, metadata vb. içerir)
  111. 📜 **Lisans**
  112. Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için `LICENSE` dosyasına bakınız.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.