market-fiyatlari-mcp-server
# Market Fiyatı MCP Server
Bu proje, Market Fiyatı API'si ile entegre olan bir MCP (Model Context Protocol) server sunmaktadır. Claude ve diğer MCP destekli AI sistemlerinin Türkiye'deki market fiyatlarını sorgulamasına olanak tanır.
## Özellikler
- **Ürün Arama**: İsim veya anahtar kelime ile ürün arama
- **Fiyat Karşılaştırma**: Farklı marketlerdeki fiyatları karşılaştırma
- **Kaynak Erişimi**: URI tabanlı kaynak erişimi (search/ ve product/ endpoint'leri)
- **MCP Araçları**: AI'ın doğrudan kullanabileceği veri analiz araçları
## Kurulum
```bash
# Bağımlılıkları yükle
npm install
# TypeScript dosyalarını derle
npm run build
# Sunucuyu başlat
npm start
```
## Claude Desktop ile Kullanım
Claude Desktop'un `claude_desktop_config.json` dosyasına aşağıdaki yapılandırmayı ekleyin:
```json
{
"mcpServers": {
"marketfiyati": {
"command": "npx",
"args": ["-y @enescinar/market-fiyati-mcp"]
}
}
}
```
## API Kaynakları
Bu MCP server, Market Fiyatı API'sinin aşağıdaki endpointlerini kullanır:
- `/search`: Ürün araması yapar
- `/searchByIdentity`: ID ile ürün getirir
## MCP Araçları
Sunucu aşağıdaki MCP araçlarını sağlar:
- `search_products`: Ürün araması yapar
- `get_product_by_id`: ID ile ürün getirir
- `compare_prices`: Fiyat karşılaştırması yapar
## MCP Kaynakları
Sunucu, üzerinden sorgulanabilecek şu MCP kaynaklarını sağlar:
- `market-fiyati://search/{query}`: Ürün araması
- `market-fiyati://product/{id}`: Ürün detayları
## Lisans
MIT
TDQS
Scored across 3 tools
Each tool has a distinct and clear purpose: search_products for searching, get_product_by_id for retrieving details by ID, and compare_prices for price comparison across markets. No overlap or ambiguity.
All tools follow a consistent snake_case verb_noun pattern (compare_prices, get_product_by_id, search_products), making it easy to infer their actions and targets.
With 3 tools, the server is well-scoped for a focused price comparison domain. Each tool is necessary and non-redundant, covering product search, detail retrieval, and price comparison.
The server covers the core functionalities for product price comparison. A minor gap is the lack of a tool to list available markets or categories, but the main workflow is complete.