Evlek MCP Server: Yapay Zeka Asistanlarına KKTC Emlak Verisi
MCP
MCP Nedir?
Model Context Protocol, Anthropic tarafından 2024’te duyurulan açık bir standart.
KKTC emlak piyasasını araştırırken yapay zeka asistanınıza soru sorduğunuzda cevaplar ancak doğru veri türü açıkça belirtildiğinde değerlidir. Evlek MCP, canlı aktif ilan ve talep fiyatı gerçeklerini yalnızca kullanıcı girdilerinden hesaplanan etiketli senaryolardan ayrı sunar.
Model Context Protocol, Anthropic tarafından 2024’te duyurulan açık bir standart. AI asistanlarının dış sistemlere bağlanması için ortak bir köprü sağlar.
Evlek tarafında güncel runtime v1.12.0: 14 tool, 7 resource ve 2 prompt aynı manifest kontratından yayınlanıyor.
ARAÇLAR
Evlek MCP Ne Sunuyor?
AI asistanlarına KKTC emlak bağlamı veren 14 manifest tool.
AI asistanlarına KKTC emlak bağlamı veren 14 manifest tool:
| Araç | Ne Sağlar |
|---|---|
search_listings | Live active sale/long-term-rent listing facts and advertised asking prices; no valuation, forecast, ranking, or recommendation. |
get_price_index | Source-dated live active-listing asking-price aggregates; not completed transactions, valuation, forecast, or advice. |
compare_cities | Descriptive city asking-price comparison with low-sample figures withheld; no ranking or investment advice. |
get_yield_estimate | Illustrative long-term-rent arithmetic only from caller-supplied purchase price, monthly rent, occupied months, and annual operating costs. |
suggest_neighborhood | Static editorial orientation with no price/yield figures, ranking, suitability finding, valuation, or recommendation. |
compare_properties | Same-type active listing facts and descriptive asking-price differences without a value judgment. |
get_district_profile | Live asking-price aggregates; any annualized rent/sale percentage is a derived asking-price ratio, not observed yield. |
student_housing | One illustrative annual-rent scenario from caller-supplied monthly rent and occupied months; university supplies location context only. |
payment_plan | Currency conversion only; no payment plan, buyer cost, legal conclusion, or financial advice. |
get_listing_detail | Return a 360° profile of one active Evlek listing by UUID: title, description, price, location, size, amenities, features, cover image, and per-photo captions and tags. Contact details are intentionally omitted. Pass a UUID from search_listings. |
search | Search live Northern Cyprus (KKTC/TRNC) property listings on Evlek with a free-text query (city, sale/rent, bedrooms). Returns matching listings as id/title/url for the fetch tool. Read-only; no contact details. |
fetch | Fetch the full detail of one Evlek listing by id (from search): title, description, GBP-normalized price, location, size, amenities. Read-only; contact details intentionally omitted. |
list_locations | Canonical cities and districts represented by active sale/long-term-rent listings; holiday-home inventory is unavailable. |
get_listing_by_number | Look up a single Evlek listing by its public listing number (e.g. “EVL-123456” or “123456”) and return its full detail — same shape as get_listing_detail. Use this when a listing number is known instead of a UUID. |
KURULUM
Nasıl Kullanılır?
Claude Desktop için yapılandırma dosyasını açın.
Claude Desktop için yapılandırma dosyasını açın:
En kolay yol — yerel proxy yok: Claude (claude.ai veya Desktop) → Settings → Connectors → “Add custom connector” ile şu URL’yi yapıştırın: https://evlek.app/api/mcp
Yalnızca yerel köprü gerektiren eski kurulumlar için mcp-remote sürümünü 0.1.16+ değerine sabitleyin (CVE-2025-6514 — sabitlenmemiş sürüm çalıştırmayın): {
"mcpServers": {
"evlek": {
"command": "npx",
"args": ["-y", "mcp-remote@0.1.16", "https://evlek.app/api/mcp"]
}
}
}
Bağlantı sonrası yeni sohbette sağ alt araç ikonunda “evlek” görünür. Deneme sorusu: “Girne ve İskele’deki aktif 2+1 satılık ilanların talep fiyatlarını karşılaştır.”
Cursor, Perplexity ve diğer MCP uyumlu istemciler için detaylı rehber: evlek.app/mcp
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
NEDEN
KKTC İçin Neden Önemli?
AI çağında görünür olmak: AI arama ve ajan yanıtlarında görünür olmak, web sayfası kadar structured data, markdown twin, llms feed ve tool output tutarlılığına bağlı.
Tutarlı veri türleri: AI arama ve ajan yanıtlarında canlı ilan gerçekleri ile model sonuçlarının ayrılması gerekir. Evlek MCP, source-dated aktif ilan/talep fiyatı verisini kullanıcı girdilerinden hesaplanan örnek senaryolardan ayrı etiketler.
Public read-only erişim: Uyumlu istemciler ilanları okuyabilir; yazamaz veya Evlek adına karar veremez.
Kapsam sınırı: Tatil evi envanteri, değerleme, gelecek tahmini, garanti, hukuki/vergi sonucu ve yatırım tavsiyesi sunulmaz.
GÜVENLİK
Güvenlik
OWASP MCP Top 10 rehberine uygun 7 katmanlı savunma.
OWASP MCP Top 10 rehberine uygun 7 katmanlı savunma:
- IP başına 60 istek/dakika + küresel 500 istek/dakika rate limit
- Zod şema doğrulama (her araç için input validation)
- Çıktı sanitizasyonu (prompt injection karşı)
- 5-10 dakikalık önbellek (veritabanı koruması)
- Supabase anon key + RLS (kullanıcı verisi erişim yok)
- 30 saniye hard timeout
- Sentry observability (her tool call breadcrumb)
YOL HARİTASI
Yol Haritası
Güncel runtime v1.12.0: 14 tool, 7 resource ve 2 prompt.
Güncel runtime v1.12.0: 14 tool, 7 resource ve 2 prompt. Bu yazı public read-only kontratı anlatır.
Kurulum 1 dakika. Kullanım ücretsiz, kayıt gerekmez.
Öne çıkanlar
Açık protokol, kapalı yazma
Veri okunabilir ama değiştirilemez. Bu, güvenlik modelinin temel kararı.
AI asistanı doğrudan sorgular
Aracı bir katman yok — asistan veriye doğrudan erişiyor, yani cevap güncel ve kaynaklı oluyor.
OWASP MCP Top 10 uygulandı
MCP'ye özgü güvenlik riskleri henüz yeni bir alan. Kabul edilmiş bir çerçeveye göre kurmak tercih edildi.
Kontrat manifestten yayınlanır
Araç, kaynak ve prompt sayıları aynı manifest kontratından yayınlanır; istemciler mevcut kapsamı buradan okuyabilir.