市场价格比较服务器 (MCP)

<div align="center" id="top">

</div>

---

<a id="english"></a>

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

📊 市场价格比较服务器

一个基于 .NET 的模型上下文协议 (MCP) 服务器应用程序，可以实时比较土耳其不同市场的杂货产品价格。

特性

• 实时跟踪土耳其市场中杂货产品的价格
• 通过多市场比较识别最实惠的价格
• 与 MCP 兼容的客户端（如 Claude 和 Cursor）集成

技术栈

• .NET 8.0 框架
• 用于数据上下文管理的 ModelContextProtocol 包

安装

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

使用

这是一个 MCP 服务器，而不是传统的 API。要使用它，您需要将其与 MCP 兼容的客户端应用程序（如 Claude 或 Cursor）集成。

与 Claude 集成

将以下配置添加到您的 claude_desktop_config.json：

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

将 PATH_TO_YOUR_PROJECT 替换为您的项目目录的实际路径。

例如：C://Users/username/Downloads

与 Cursor 集成

Cursor 也支持 MCP 作为客户端。按照以下步骤进行集成：

1. 打开 Cursor AI IDE

2. 转到 Settings → Features → MCP

3. 点击 Add New MCP Server

4. 填写配置：

   • Name: MarketPrices (或您喜欢的任何名称)
   • Type: command (对于本地进程)
   • Command: 添加以下命令：

   dotnet run --project "PATH_TO_YOUR_PROJECT/MarketPricesMCP/MarketPricesMCP/MarketPricesMCP.csproj" --no-build
   

   将 PATH_TO_YOUR_PROJECT 替换为您的实际项目路径

5. 点击 Add 保存

6. 验证 Cursor 中的服务器指示器是否变为绿色（表示连接成功）

Cursor 集成故障排除：

• 如果您遇到“no tools found”错误，请确保您已安装 Node.js（包括 npm）
• 验证 MCP 服务器是否正在正确运行
• 检查您的项目文件路径是否正确

对于其他 MCP 兼容系统

根据系统的要求，配置系统以指向 MCP 服务器的可执行文件或项目文件。

如何使用：

• 仅输入土耳其语的产品名称（例如，“salatalık”、“domates”、“süt”）
• 该工具将搜索主要的土耳其杂货市场以找到最优惠的价格
• 结果包括多个商店的价格比较

MCP 协议详情

Market Prices MCP 服务器提供以下上下文类型：

• Title - 关于特定产品的信息
• Brand - 品牌信息
• Price - 产品价格金额
• Market - 产品市场的名称

截图

<img src="https://github.com/user-attachments/assets/3f446a9e-a56c-4243-853d-936fc569471f" width="300" alt="Visual Studio Code Copilot Implementation"> <p><em>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>Visual Studio Code Copilot 中的输出</em></p>

<div align="right"> <a href="#top">⬆️ 返回顶部</a> </div>

---

<a id="turkish"></a>

<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:

1. Cursor AI IDE'yi açın

2. Ayarlar → Özellikler → MCP yolunu izleyin

3. Yeni MCP Sunucusu Ekle düğmesine tıklayın

4. 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

5. Kaydetmek için Ekle'ye tıklayın

6. 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>