market-fiyatlari

Market Fiyatı MCP Sunucusu, Türkiye piyasasındaki market fiyatlarını merkezi bir şekilde sorgulayabilecek şekilde tasarlanmış bir MCP sunucusudur. Sunucu, Market Fiyatı API'sini kullanarak ürün arama (search), ürün detayını getirme (product by id) ve fiyat karşılaştırması (compare_prices) gibi araçlar sağlar. MCP araçları sayesinde Claude gibi MCP destekli yapay zeka sistemleri, entegre bir şekilde ürün arama sonuçlarını ve karşılaştırmalı fiyatları analiz edebilir. Sunucunun kaynakları market-fiyati://search/{query} ve market-fiyati://product/{id} biçiminde kullanılarak gerekli veriye erişim imkanı sunar. Ayrıca AI sistemleri için doğrudan analiz araçları da mevcuttur (search_products, get_product_by_id, compare_prices).

Kullanırken, önce marketfiyati MCP servisini kurup başlattıktan sonra, MCP destekli müşterinizde aşağıdaki kaynakları kullanabilirsiniz: market-fiyati://search/{query} ile ürün araması yapabilir, market-fiyati://product/{id} ile belirli bir ürünün ayrıntılarını alabilir ve compare_prices aracı ile farklı marketlerdeki fiyatları karşılaştırabilirsiniz. Bununla birlikte, araçlar ve kaynaklar, Market Fiyatı API'sinin yanıtlarını normalize ederek AI'nın NLP tabanlı sorgularını daha etkili yanıtlar üretmek için kullanılır.

Gerekli Önkoşullar

• Node.js ve npm yüklü olmalıdır (örn. Node.js LTS sürümü).
• İnternet bağlantısı ve npm paketleri için yetkili erişim.

Kurulum Adımları

1. Proje kök dizinine gidin ve bağımlılıkları yükleyin:

npm install

2. TypeScript dosyalarını derleyin:

npm run build

3. Sunucuyu başlatın:

npm start

Notlar

• MCP sunucusunu çalıştırırken ağ erişimi ve gerekli API anahtarları (varsa) konusunda güvenlik ayarlarınıza dikkat edin.
• Eğer özel bir yapılandırma dosyası kullanıyorsanız, README’deki yönergelere uygun şekilde CLI argümanlarını ekleyin.

İpuçları ve sorun giderme:

• MCP aksesuarları (search_products, get_product_by_id, compare_prices) doğru çalışması için Market Fiyatı API'sinin erişilebilir olduğundan emin olun.
• environment variablelar gerektirse, VAR_NAME gibi değişkenleri .env dosyasına veya sistem ortam değişkenlerine ekleyin. Örneğin, API_KEY veya BASE_URL gibi değişkenler talep edilebilir.
• Kaynak URI’ları (market-fiyati://search/{query} ve market-fiyati://product/{id}) ile test sorguları yaparken boşluklar ve özel karakterler için URL encoding kullanın.
• Paket adı değişikliği veya entegrasyon güncellemeleri olabilir. En son sürüm için npm paket sayfasını kontrol edin.