MCP Sunucusu

Kahve Tabela, atlas verisini Model Context Protocol (MCP) üzerinden de sunar. Yapay zekâ asistanları bu sunucuya bağlanıp Türkiye'nin kültürel miras noktalarını, coğrafi işaret tescilli yöre yemeklerini ve Mavi Koy kıyı atlasını doğrudan sorgulayabilir. Sunucu salt-okunurdur: veri yazmaz, kullanıcı verisi görmez, anahtar istemez.

Bağlanma

Uzak (hosted) bir sunucudur; kurulum ya da paket indirme gerekmez. Streamable HTTP taşıması kullanır.

Endpoint: https://kahvetabela.com/api/mcp
Resmî MCP Registry kaydı: com.kahvetabela/public-read

İstemci yapılandırması

HTTP taşımasını destekleyen istemcilerde (Claude Code, Claude Desktop ve MCP uyumlu diğer istemciler) yapılandırma dosyanıza şunu ekleyin:

{
  "mcpServers": {
    "kahvetabela": {
      "type": "http",
      "url": "https://kahvetabela.com/api/mcp"
    }
  }
}

Doğrudan denemek için

Araç listesini ham JSON-RPC ile de alabilirsiniz:

curl -s https://kahvetabela.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Araçlar

Sekiz araç; hepsi salt-okunur. Tam girdi şemaları için sunucunun kendi tools/list yanıtına bakın.

Araç	Ne yapar
search_places	İl, ilçe, kategori veya serbest metinle miras noktası ara.
get_place	Tek bir noktanın tüm alanlarını id ile getir.
nearby_places	Bir koordinatın çevresindeki noktaları mesafe sırasıyla getir; sürüş modu için sesli not bağlantısı da verir.
get_page_markdown	Desteklenen bir sayfayı HTML yerine sade markdown olarak oku.
search_dishes	Yöre yemeklerinde ara; coğrafi işaret tescilli olanlarla sınırlanabilir.
get_dish	Tek bir yemeği slug ile getir (tescil türü ve numarası dahil).
search_mavi_koy	Mavi Koy kıyı atlasında koy, plaj ve kıyı noktası ara.
get_mavi_koy_place	Tek bir kıyı noktasını slug ile getir.

Kullanım ve sınırlar

Anahtar veya kayıt gerekmez; makul kullanım rica ederiz.
Yalnızca herkese açık veri döner: kullanıcı hesapları, e-postalar ve moderasyon kuyruğu bu yüzeyde yoktur.
Mükerrer kayıtlar filtrelenir; sunucu size 308 yönlendirilen bir kimlik vermez.
Yanıtlar Türkçe ve İngilizce olarak alınabilir (lang parametresi).

Atıf ve lisans

Veriyi kullanırken atıf yapmanız gerekir: “Kahve Tabela · Türkiye Kültürel Miras Atlası, kahvetabela.com”. Ham veriyi yeniden yayımlarken orijinal kaynağın lisansına (OpenStreetMap ODbL, Wikimedia CC vb.) da uymanız gerekir. Kaynak dökümü, toplu indirmeler ve kalıcı DOI için açık veri sayfasına bakın.