Market Price Comparison Server (MCP)

</div>

<div align="right"> <a href="#turkish">Türkçe</a> </div>

📊 Market Price Comparison Server

A .NET-based Model Context Protocol (MCP) server application that compares grocery product prices across different markets in Turkey in real-time.

Features

Real-time price tracking for grocery products in Turkish markets
Most affordable price identification with multi-market comparison
Integration with MCP-compatible clients (like Claude and Cursor)

Technology Stack

.NET 8.0 Framework
ModelContextProtocol package for data context management

Installation

git clone https://github.com/Eneswunbeaten/MarketPricesMCP.git
cd MarketPricesMCP
dotnet restore
dotnet build

Usage

This is an MCP server, not a traditional API. To use it, you need to integrate it with MCP-compatible client applications (like Claude or Cursor).

Integration with Claude

Add the following configuration to your claude_desktop_config.json:

{
    "mcpServers": {
        "MarketPrices": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "PATH_TO_YOUR_PROJECT/MarketPricesMCP/MarketPricesMCP/MarketPricesMCP.csproj",
                "--no-build"
            ]
        }
    }
}

Replace PATH_TO_YOUR_PROJECT with the actual path to your project directory.

For example: C://Users/username/Downloads

Integration with Cursor

Cursor also supports MCP as a client. Follow these steps to integrate:

Open Cursor AI IDE
Go to Settings → Features → MCP
Click on Add New MCP Server
Fill in the configuration:
- Name: MarketPrices (or any name you prefer)
- Type: command (for local process)
- Command: Add the following command:
```
dotnet run --project "PATH_TO_YOUR_PROJECT/MarketPricesMCP/MarketPricesMCP/MarketPricesMCP.csproj" --no-build
```
Replace PATH_TO_YOUR_PROJECT with your actual project path
Click Add to save
Verify that the server indicator in Cursor turns green (indicating successful connection)

Troubleshooting Cursor Integration:

If you encounter a "no tools found" error, make sure you have Node.js installed (includes npm)
Verify the MCP server is running correctly
Check that the path to your project file is correct

For Other MCP-Compatible Systems

Configure the system to point to the MCP server's executable or project file according to the system's requirements.

How to use:

Enter only the product name in Turkish (e.g., "salatalık", "domates", "süt")
The tool will search across major Turkish grocery markets to find the best price
Results include price comparison across multiple stores

MCP Protocol Details

The Market Prices MCP server provides the following context types:

Title - Information about a specific product
Brand - Brand information
Price - Product Price Amount
Market - Name from Product's market

Screenshots

<img src="https://github.com/user-attachments/assets/3f446a9e-a56c-4243-853d-936fc569471f" width="300" alt="Visual Studio Code Copilot Implementation"> <p><em>Working principle in Visual Studio Code Copilot</em></p> <img src="https://github.com/user-attachments/assets/33d1298c-dddb-4106-9283-8d8ca9b5fb0d" width="300" alt="Visual Studio Code Copilot Output"> <p><em>Output in Visual Studio Code Copilot</em></p> <div align="right"> <a href="#top">⬆️ Back to top</a> </div>

<div align="right"> <a href="#english">English</a> </div>

📊 Market Fiyat Karşılaştırma Sunucusu

Model Context Protocol (MCP) kullanılarak .NET ile geliştirilmiş, Türkiye'deki farklı marketlerdeki ürün fiyatlarını gerçek zamanlı olarak karşılaştıran bir sunucu uygulaması.

Özellikler

Türk marketlerindeki market ürünleri için gerçek zamanlı fiyat takibi
En uygun fiyat tespiti ile çoklu market karşılaştırması
MCP uyumlu istemcilerle (Claude ve Cursor gibi) entegrasyon

Teknoloji Yığını

.NET 8.0 Framework
Veri context yönetimi için ModelContextProtocol paketi

Kurulum

git clone https://github.com/Eneswunbeaten/MarketPricesMCP.git
cd MarketPricesMCP
dotnet restore
dotnet build

Kullanım

Bu bir MCP sunucusudur, geleneksel bir API değildir. Kullanmak için MCP uyumlu istemci uygulamalarla (Claude veya Cursor gibi) entegre etmeniz gerekmektedir.

Claude ile Entegrasyon

claude_desktop_config.json dosyanıza aşağıdaki yapılandırmayı ekleyin:

{
    "mcpServers": {
        "MarketPrices": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "PROJE_YOLUNUZ/MarketPricesMCP/MarketPricesMCP/MarketPricesMCP.csproj",
                "--no-build"
            ]
        }
    }
}

PROJE_YOLUNUZ kısmını kendi proje dizininizin gerçek yolu ile değiştirin.

Örneğin: C://Users/kullaniciadi/Downloads

Cursor ile Entegrasyon

Cursor da MCP protokolünü desteklemektedir. Entegrasyon için şu adımları izleyin:

Cursor AI IDE'yi açın
Ayarlar → Özellikler → MCP yolunu izleyin
Yeni MCP Sunucusu Ekle düğmesine tıklayın
Yapılandırmayı doldurun:
- İsim: MarketPrices (veya istediğiniz bir isim)
- Tür: command (yerel işlem için)
- Komut: Aşağıdaki komutu ekleyin:
```
dotnet run --project "PROJE_YOLUNUZ/MarketPricesMCP/MarketPricesMCP/MarketPricesMCP.csproj" --no-build
```
PROJE_YOLUNUZ kısmını gerçek proje yolunuzla değiştirin
Kaydetmek için Ekle'ye tıklayın
Cursor'daki sunucu göstergesinin yeşil olduğunu doğrulayın (başarılı bağlantı anlamına gelir)

Cursor Entegrasyonu Sorun Giderme:

"araç bulunamadı" hatası alırsanız, .Net'in kurulu olduğundan emin olun.
MCP sunucusunun doğru çalıştığını kontrol edin
Proje dosya yolunun doğru olduğundan emin olun

Diğer MCP Uyumlu Sistemler İçin

Sistemi, MCP sunucusunun yürütülebilir dosyasına veya proje dosyasına işaret edecek şekilde sistemin gereksinimlerine göre yapılandırın.

Nasıl kullanılır:

Sadece Türkçe olarak ürün adını girin (örn. "salatalık", "domates", "süt")
Araç, en iyi fiyatı bulmak için büyük Türk marketlerini tarayacaktır
Sonuçlar, birden fazla mağaza arasında fiyat karşılaştırması içerir

MCP Protokol Detayları

Market Fiyatları MCP sunucusu aşağıdaki bağlam türlerini sağlar:

Title - Belirli bir ürün hakkında bilgi
Brand - Marka bilgisi
Price - Ürün fiyat tutarı
Market - Ürünün market adı

Ekran Görüntüleri

<img src="https://github.com/user-attachments/assets/3f446a9e-a56c-4243-853d-936fc569471f" width="300" alt="Visual Studio Code Copilot Üzerindeki Çalışma prensibi"> <p><em>Visual Studio Code Copilot Üzerindeki Çalışma prensibi</em></p> <img src="https://github.com/user-attachments/assets/33d1298c-dddb-4106-9283-8d8ca9b5fb0d" width="300" alt="Visual Studio Code Copilot Üzerindeki Çıktısı"> <p><em>Visual Studio Code Copilot Üzerindeki Çıktısı</em></p> <div align="right"> <a href="#top">⬆️ Başa dön</a> </div>