Skip to content
Back to search

ihale-mcp

MCP Server for Turkish Government Tenders

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--ihale-mcp/badge.svg)](/listings/saidsurucu--ihale-mcp)

HTML

<a href="/listings/saidsurucu--ihale-mcp"><img src="/api/listings/saidsurucu--ihale-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 · 229 lines

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

  1. # İhale MCP: Türkiye Kamu İhaleleri için MCP Sunucusu
  2. Bu proje, Türkiye'deki kamu ihalelerine (`ekap.kik.gov.tr`) erişimi kolaylaştıran bir [FastMCP](https://gofastmcp.com/) sunucusu oluşturur. Bu sayede, EKAP v2 portalından ihale arama, ihale detaylarını getirme ve ihale duyurularını Markdown formatında alma 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. ---
  4. ## 🚀 5 Dakikada Başla (Remote MCP)
  5. **✅ Kurulum Gerektirmez! Hemen Kullan!**
  6. 🔗 **Remote MCP Adresi:** `https://ihale.surucu.dev/mcp`
  7. ### Claude Desktop ile Kullanım
  8. 1. Claude Desktop'ı açın
  9. 2. **Settings → Connectors → Add Custom Connector**
  10. 3. Bilgileri girin:
  11. - **Name:** `İhale MCP`
  12. - **URL:** `https://ihale.surucu.dev/mcp`
  13. 4. **Add** butonuna tıklayın
  14. 5. Hemen kullanmaya başlayın! 🎉
  15. ---
  16. 🎯 **Temel Özellikler**
  17. * EKAP v2 portalına programatik erişim için standart bir MCP arayüzü.
  18. * Aşağıdaki yetenekler:
  19. * **Detaylı İhale Arama:** İhale adı/içeriği, IKN numarası, ihale türü, il, tarih aralıkları ve 17+ boolean filtre ile kapsamlı arama.
  20. * **İhale Detayları:** Belirli bir ihalenin tam detaylarını (özellikler, OKAS kodları, idare bilgileri, işlem kuralları) getirme.
  21. * **İhale Duyuruları:** İhale ile ilgili tüm duyuruları (Ön İlan, İhale İlanı, Sonuç İlanı vb.) otomatik HTML-to-Markdown dönüşümü ile getirme.
  22. * **OKAS Kod Arama:** Türk kamu alım sınıflandırma kodlarında arama yapma.
  23. * **İdare Arama:** Bakanlık, belediye, üniversite gibi kamu kurumlarını arama.
  24. * **İlan.gov.tr Entegrasyonu:** Resmi devlet ilanları, UYAP e-satış, icra/mahkeme satışları, kamu personel duyuruları ve tebligat aramalar.
  25. * İhale metinlerinin LLM'ler tarafından daha kolay işlenebilmesi için HTML'den Markdown formatına çevrilmesi.
  26. * Claude Desktop uygulaması ile kolay entegrasyon.
  27. * İhale MCP, [5ire](https://5ire.app) gibi Claude Desktop haricindeki MCP istemcilerini de destekler.
  28. ---
  29. 🚀 **Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)**
  30. Bu bölüm, İhale MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.
  31. * **Python Kurulumu:** Sisteminizde Python 3.11 veya üzeri 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/) indirebilirsiniz.
  32. * **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.
  33. * **`uv` Kurulumu:**
  34. * **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"`
  35. * **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`
  36. * **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.
  37. * İşletim sisteminize uygun [5ire](https://5ire.app) MCP istemcisini indirip kurun.
  38. * 5ire'ı açın. **Workspace -> Providers** menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
  39. * **Tools** menüsüne girin. **+Local** veya **New** yazan butona basın.
  40. * **Tool Key:** `ihalemcp`
  41. * **Name:** `İhale MCP`
  42. * **Command:**
  43. ```
  44. uvx --from git+https://github.com/saidsurucu/ihale-mcp ihale-mcp
  45. ```
  46. * **Save** butonuna basarak kaydedin.
  47. * Şimdi **Tools** altında **İhale 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ı).
  48. * Artık İhale MCP ile konuşabilirsiniz.
  49. ---
  50. ⚙️ **Claude Desktop Manuel Kurulumu**
  51. 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.
  52. 2. Claude Desktop **Settings -> Developer -> Edit Config**.
  53. 3. Açılan `claude_desktop_config.json` dosyasına `mcpServers` altına ekleyin:
  54. ```json
  55. {
  56. "mcpServers": {
  57. "İhale MCP": {
  58. "command": "uvx",
  59. "args": [
  60. "--from", "git+https://github.com/saidsurucu/ihale-mcp",
  61. "ihale-mcp"
  62. ]
  63. }
  64. }
  65. }
  66. ```
  67. 4. Claude Desktop'ı kapatıp yeniden başlatın.
  68. > **Not:** EKAP v2, API isteklerini insan doğrulamasına (Cloudflare Turnstile) bağladı. İhale MCP bu doğrulamayı yerleşik tarayıcısıyla otomatik geçer; ek bir işlem gerekmez. Doğrulama çerezi yaklaşık 5 dakika geçerlidir; süresi dolunca ilk istek birkaç saniye daha uzun sürer.
  69. 🛠️ **Kullanılabilir Araçlar (MCP Tools)**
  70. Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:
  71. * **`search_tenders`**: EKAP v2 portalında kapsamlı ihale arama yapar.
  72. * **Ana Parametreler**: `search_text`, `ikn_year`, `ikn_number`, `tender_types`, `tender_date_start/end`, `announcement_date_start/end`
  73. * **Boolean Filtreler**: `e_ihale`, `ortak_alim_mi`, `kismi_teklif_mi`, `yabanci_isteklilere_izin_veriliyor_mu` ve 13+ daha fazla filtre
  74. * **Liste Filtreleri**: `provinces`, `tender_statuses`, `tender_methods`, `okas_codes`, `authority_ids`, `proposal_types`, `announcement_types`
  75. * **Arama Kapsamı**: `search_in_title`, `search_in_announcement`, `search_in_tech_spec` vb. 11 farklı alan
  76. * **Döndürdüğü Değer**: Sayfalanmış ihale listesi, toplam sonuç sayısı
  77. * **`search_okas_codes`**: OKAS (kamu alım sınıflandırma) kodlarında arama yapar.
  78. * **Parametreler**: `search_term`, `kalem_turu` (1=Mal, 2=Hizmet, 3=Yapım), `limit`
  79. * **Döndürdüğü Değer**: OKAS kodları, açıklamaları ve kategorileri
  80. * **`search_authorities`**: Türk kamu kurumlarında arama yapar.
  81. * **Parametreler**: `search_term`, `limit`
  82. * **Döndürdüğü Değer**: Kurum ID'leri, isimleri ve hiyerarşik bilgileri
  83. * **`get_recent_tenders`**: Son N gündeki ihaleleri getirir.
  84. * **Parametreler**: `days` (1-30), `tender_types`, `limit`
  85. * **Döndürdüğü Değer**: Yakın tarihli ihale listesi
  86. * **`get_tender_announcements`**: Belirli bir ihalenin tüm duyurularını getirir.
  87. * **Parametreler**: `tender_id`
  88. * **Döndürdüğü Değer**: Otomatik HTML-to-Markdown dönüştürülmüş ihale duyuruları
  89. * **Sonuç İlanları için ek**: Sonuç İlanı (tip 4) duyuruları ayrıca ayrıştırılmış bir `result_info` nesnesi taşır: `winner` (yüklenici), `contract_amount` (sözleşme bedeli), `estimated_cost` (yaklaşık maliyet), `bid_count`, `valid_bid_count`, `contract_date`. Böylece istemcinin markdown'ı regex ile ayıklaması gerekmez.
  90. * **`search_tender_results_by_bidder`**: Bir firmanın **kazandığı** ihaleleri, daraltılmış bir kapsamdaki sonuç ilanlarını tarayarak bulur.
  91. * **Parametreler**: `bidder_name` (zorunlu), `authority_ids` / `provinces` / `okas_codes` (en az biri zorunlu), `date_start`, `date_end`, `tender_types`, `max_tenders`
  92. * **Döndürdüğü Değer**: `matches` (İKN, yüklenici, sözleşme bedeli, yaklaşık maliyet, teklif sayısı), `match_count`, `scanned_tenders`
  93. * ⚠️ **Bu bir taramadır, tam indeks değildir.** EKAP'ın metin arama indeksi sonuç ilanlarını kapsamaz; kazanan adı orada aranamaz. Bu nedenle bir firmanın kazandığı **tüm** ihaleleri listelemek mümkün değildir. Kapsam daraltılmadan (idare/il/OKAS) araç çalışmaz; kapsam `max_tenders`'ı aşarsa sessizce kesmek yerine gerçek kapsam büyüklüğüyle hata döner.
  94. * Kısmi teklifli ihalelerde her kısım ayrı kayıt olarak döner (`announcement_index`).
  95. * **`get_tender_details`**: Belirli bir ihalenin kapsamlı detaylarını getirir.
  96. * **Parametreler**: `tender_id`
  97. * **Döndürdüğü Değer**: İhale özellikleri, OKAS kodları, idare bilgileri, işlem kuralları ve otomatik markdown'a çevrilmiş duyuru özetleri
  98. * **`search_ilan_ads`**: İlan.gov.tr'de resmi devlet ilanlarında arama yapar.
  99. * **Parametreler**: `search_text`, `city_plate`, `ad_type_filter`, `ad_source_filter`, `publish_date_min/max`, `price_min/max`
  100. * **İlan Türleri**: İCRA, İHALE, TEBLİGAT, PERSONEL
  101. * **İlan Kaynakları**: UYAP (E-SATIŞ icra/mahkeme satışları), BIK (Basın İlan Kurumu)
  102. * **Döndürdüğü Değer**: Resmi devlet ilanları, kategori bilgileri, şehir sayıları
  103. * **`get_ilan_ad_detail`**: Belirli bir ilan için detaylı bilgileri getirir.
  104. * **Parametreler**: `ad_id`
  105. * **Döndürdüğü Değer**: İlan başlığı, otomatik HTML-to-Markdown çevrilmiş içerik, ilan veren kurum bilgileri, lokasyon, kategoriler
  106. ---
  107. 🧩 **Doğrudan Temin (Direct Procurement – Doğrudan Temin) Araçları**
  108. Doğrudan Temin ekranındaki filtrelerle uyumlu ek MCP araçları:
  109. * **`search_direct_procurements`**: Doğrudan Temin listesi (Direct Procurement list).
  110. * **Önemli Parametreler (English with Türkçe)**:
  111. - `year (Yıl)`, `dt_no / dt_number (DT No / DT Sayı)`
  112. - `dt_type (Tür)`: 1=Goods (Mal), 2=Construction (Yapım), 3=Service (Hizmet), 4=Consultancy (Danışmanlık)
  113. - `e_price_offer (E‑Fiyat Teklifi)` → `eihale=true/false`
  114. - `status_id/status_text (Durum)`: 202=Doğrudan Temin Duyurusu Yayımlanmış, 3=Teklifler Değerlendiriliyor, 4=Doğrudan Temin Sonuçlandırıldı, 5=Sonuç Bilgileri Gönderildi, 15=Sonuç Duyurusu Yayımlanmış
  115. - `date_start/date_end (Teklif tarihi)` → `dtTarihiBaslangic/Bitis`
  116. - `province_plate/province_name (İl)`
  117. - `scope_id/scope_text (Kapsam)`: 101=4734, 102=İstisna, 103=Kapsam Dışı
  118. - `authority_id (İdare ID token)` (idareAra’dan), `parent_authority_code (Bağlı Olduğu Üst İdare / ustIdareKod)`
  119. * **Not**: Bazı filtreler (Durum/Kapsam/İdare) oturum gerektirebilir. Gerekirse `cookies` (Çerez) header değeri verilebilir; istemci ayrıca otomatik ısınma (warm‑up) yapar.
  120. * **`get_direct_procurement_details`**: DT detayları (Details) – `dogrudanTeminId (E10)` + `idareId (E11)` ile.
  121. * **`search_direct_procurement_authorities`**: İdare (Authority) araması; dönen `token`, `search_direct_procurements` içinde `authority_id` olarak kullanılır.
  122. * **`search_direct_procurement_parent_authorities`**: Üst İdare (Parent Authority) araması; dönen `token`, `parent_authority_code (ustIdareKod)` olarak kullanılır.
  123. Örnek (Examples)
  124. ```text
  125. search_direct_procurements(
  126. dt_type=1, # Goods (Mal)
  127. province_name="Antalya", # İl adı
  128. status_text="Doğrudan Temin Duyurusu Yayımlanmış",
  129. date_start="2025-09-01",
  130. date_end="2025-09-11"
  131. )
  132. # İdare ara → token’ı listede kullan
  133. search_direct_procurement_authorities("antalya")
  134. # => take authorities[0].token as authority_id
  135. search_direct_procurements(
  136. authority_id="<EIdareToken>",
  137. parent_authority_code="44|07", # Bağlı Olduğu Üst İdare (ustIdareKod)
  138. year=2025, dt_number=1493227
  139. )
  140. ```
  141. ## İhale Türleri
  142. - **1 - Mal**: Malzeme ve ekipman alımları
  143. - **2 - Yapım**: İnşaat ve altyapı projeleri
  144. - **3 - Hizmet**: Hizmet sözleşmeleri
  145. - **4 - Danışmanlık**: Danışmanlık hizmetleri
  146. ## Örnek Kullanımlar
  147. ### EKAP v2 İhaleleri
  148. 1. **Pazar Araştırması**: Belirli sektör veya bölgelerdeki fırsatları takip etme
  149. 2. **Uygunluk İzleme**: Mevzuata uygunluk için ihale duyurularını takip etme
  150. 3. **İş Zekası**: Kamu harcama modellerini ve trendlerini analiz etme
  151. 4. **Bildirim Sistemleri**: Belirli ihale türleri için uyarı sistemleri kurma
  152. 5. **Veri Analizi**: Araştırma ve analiz için ihale verilerini çıkarma
  153. ### İlan.gov.tr Resmi İlanları
  154. 6. **UYAP E-SATIŞ Takibi**: İcra dairesi ve mahkeme satışlarını izleme
  155. 7. **Personel Duyuruları**: Kamu personel alım ilanlarını takip etme
  156. 8. **Tebligat İzleme**: Resmi tebligat ve duyuruları takip etme
  157. 9. **Belediye İhaleleri**: Yerel yönetim ihale ilanlarını izleme
  158. 10. **Emlak Satışları**: Kamu kurumlarının emlak satış ilanları
  159. ## Yeni Özellikler
  160. ✅ **17+ Boolean Filtre**: e-İhale, ortak alım, kısmi teklif, yabancı katılım vb.
  161. ✅ **Liste Filtreleri**: İller, ihale durumları, usulleri, OKAS kodları, idare ID'leri
  162. ✅ **Arama Kapsamı Kontrolü**: IKN, başlık, duyuru, teknik şartname vb. alanlarda arama
  163. ✅ **İdare Arama**: 72,000+ kamu kurumunda arama (bakanlık, belediye, üniversite)
  164. ✅ **İhale Duyuruları**: Otomatik HTML-to-Markdown dönüşümü ile tam duyuru metinleri
  165. ✅ **Kapsamlı İhale Detayları**: Tüm ihale metadata'sı, özellikler, kurallar bir arada
  166. ✅ **İlan.gov.tr Entegrasyonu**: 20,000+ resmi devlet ilanı aramalar
  167. ✅ **UYAP E-SATIŞ**: 46,000+ icra/mahkeme satış ilanlarına özel erişim
  168. ✅ **İlan Detayları**: Otomatik HTML-to-Markdown dönüşümü ile tam ilan içerikleri
  169. ✅ **Çoklu İlan Türü**: İCRA, İHALE, TEBLİGAT, PERSONEL kategorileri
  170. ## API Hız Limitleri
  171. Bu sunucu EKAP portalının hız limitlerini gözetir. Üretim kullanımı için aşağıdakileri göz önünde bulundurun:
  172. - API çağrılarını azaltmak için istek önbellekleme
  173. - Üstel geri çekilme ile yeniden deneme mantığı
  174. - Yüksek hacimli kullanım için istek sırası
  175. 📜 **Lisans**
  176. Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için `LICENSE` dosyasına bakınız.
  177. ## Sorumluluk Reddi
  178. Bu, Türk hükümetinin EKAP portalı ile resmi olmayan bir entegrasyondır. Kullanıcılar portalın hizmet şartlarına ve geçerli düzenlemelere uymakla yükümlüdür. Yazarlar Türk hükümeti veya EKAP portalı ile bağlantılı değildir.

Ratings and comments

Sign in to rate this skill.

Sign in

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