Skip to main content
Glama
EnesCinr

market-fiyatlari-mcp-server

by EnesCinr
README.md
# 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

A3.5/5.0

Scored across 3 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityInactive
ResponsivenessNo issues