Bargainer MCP Client

🚀 Bargainer MCP Client 🛍️

Bargainer MCP Clientは、Slickdeals、RapidAPIマーケットプレイス、ウェブスクレイピングなど、複数のソースからの取引を検索し、比較するための強力なModel Context Protocol (MCP) クライアントです。対話型の取引検索を行うための最新のウェブベースのチャットインターフェースを備えています。

✨ 主な機能

• 複数ソースの取引集約：Slickdeals API、RapidAPIマーケットプレイス、ウェブスクレイピングと統合
• 対話型チャットインターフェース：Socket.IOを介したリアルタイムメッセージングを備えた最新のウェブUI
• インテリジェントな取引フィルタリング：価格、評価、店舗、カテゴリでフィルタリング
• 取引比較：複数のソース間で取引を比較
• MCPプロトコル統合：6つの特殊ツールを備えた完全なModel Context Protocolの実装
• プロバイダパターンアーキテクチャ：新しい取引ソースを追加するための拡張可能な設計
• TypeScript：厳格な型チェックを備えた完全に型付けされたコードベース

🚀 クイックスタート

前提条件

• Node.js 18+
• npmまたはyarn
• 外部サービスのAPIキー（オプション、モックデータにフォールバック）

インストール

# リポジトリをクローン
git clone https://github.com/karthiksivaramms/bargainer-mcp-client.git
cd bargainer-mcp-client

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

使用方法

ウェブチャットインターフェース

# ウェブインターフェースを起動
npm run web

# または開発用の自動リロードで起動
npm run dev:web

その後、ブラウザでhttp://localhost:3001 を開き、チャットを始めましょう！

MCPサーバー

# MCPサーバーを起動
npm run dev

# またはビルドされたバージョンを実行
npm start

デモとテスト

# 対話型デモを実行
npm run demo

# サーバーをテスト
npm run test:server

💬 利用可能なコマンド

チャットインターフェースでは、これらの自然言語コマンドを使用できます。

• 取引を検索：「500ドル未満のラップトップの取引を探す」
• トップ取引を取得：「今日のトップエレクトロニクスの取引を見せて」
• 取引をフィルタリング：「100ドル未満で4星以上のゲーミングヘッドフォン」
• 取引の詳細：「このiPhoneの取引についてもっと教えて」
• 取引を比較：「iPadの取引をソース間で比較する」
• ソースを一覧表示：「利用可能な取引ソースは何ですか？」

🛠️ MCPツール

サーバーは6つの特殊ツールを提供します。

1. search_deals - 商品名またはキーワードで取引を検索
2. get_top_deals - すべてのソースからのトレンド取引を取得
3. filter_deals - 価格、評価、店舗、カテゴリで取引をフィルタリング
4. get_deal_details - 特定の取引の詳細情報を取得
5. compare_deals - 複数のソース間で取引を比較
6. get_available_sources - すべての構成された取引ソースを一覧表示

🏗️ アーキテクチャ

src/
├── server.ts              # メインのMCPサーバー
├── providers/             # 取引ソースプロバイダー
│   ├── base.ts           # ベースプロバイダーインターフェース
│   ├── slickdeals.ts     # Slickdeals APIプロバイダー
│   ├── rapidapi.ts       # RapidAPIマーケットプレイスプロバイダー
│   └── webscraping.ts    # ウェブスクレイピングプロバイダー
├── services/
│   └── aggregator.ts     # 取引集約サービス
└── types/                # TypeScriptの型定義

ui/
├── index.html            # チャットインターフェース
├── chat-interface.js     # フロントエンドのJavaScript
└── server.js             # Socket.IOを備えたExpressサーバー

test/                     # テストファイル
scripts/                  # ユーティリティスクリプト

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

開発環境のセットアップ

# 依存関係をインストール
npm install

# 自動リロードで開発を開始
npm run dev

# 自動リロードでウェブインターフェースを開始
npm run dev:web

# リントを実行
npm run lint

# コードを整形
npm run format

新しい取引ソースの追加

1. src/providers/に新しいプロバイダーを作成する
2. BaseDealProviderを拡張する
3. 必要なメソッドを実装する
4. aggregator.tsに登録する

📚 ドキュメント

取引オブジェクトの構造

interface Deal {
  id: string;
  title: string;
  price: number;
  originalPrice?: number;
  discount?: number;
  rating?: number;
  store: string;
  url: string;
  imageUrl?: string;
  description?: string;
  category?: string;
  source: string;
  timestamp: Date;
}

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

👨‍💻 作者

Karthik Sivaram M

• GitHub: @karthiksivaramms

💡 サポート

質問がある場合や問題が発生した場合は、GitHubでissueを開いてください。

🗺️ ロードマップ

• [ ] より多くの取引ソースの統合
• [ ] 取引アラートと通知
• [ ] 価格履歴の追跡
• [ ] 高度なフィルタリングオプション
• [ ] モバイルアプリバージョン
• [ ] 取引共有機能

世界中の格安探し愛好家のために❤️ で作られました！