MCP Food Search

🚀 食料品検索MCPサーバー

食料品の価格と栄養情報の検索機能を提供するMCP（Model Context Protocol）サーバーです。このサーバーを使うと、AIエージェントが食品を検索し、価格を比較し、異なる食料品店の栄養成分を分析することができます。

✨ 主な機能

• 商品検索：サポートされている店舗全体で商品名を指定して食料品を検索します。
• 価格比較：食品の現在の価格情報を取得します。
• 栄養分析：タンパク質、カロリー、その他の主要栄養素の情報を取得します。
• ドルあたりのタンパク質ランキング：消費したドルあたりのタンパク質含有量で自動的に商品をランク付けします。
• 店舗サポート：現在はTrader Joe'sをサポートしており、今後は他の店舗も追加予定です。

📦 インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd MCP_Food_Search

2. 依存関係をインストールします：

pip install -r requirements.txt

または開発モードでインストールします：

pip install -e .

💻 使用例

基本的な使用法

# MCPサーバーを起動する
python -m grocery_search_mcp.server

またはスクリプトエントリポイントを使用します：

grocery-search-mcp

高度な使用法

# 実装をテストする
python test_server.py

MCPツールの使用

サーバーは1つの主要なツールを提供します：

GroceryPrices.search

価格と栄養情報を含む食料品を検索します。

パラメーター:

• query (必須): 検索する食品または商品名
• store (オプション): 検索する店舗。デフォルトは "trader_joes"

例:

{
  "query": "protein bar",
  "store": "trader_joes"
}

レスポンス: 以下の情報を含む整形された商品リストを返します：

• 商品名とブランド
• 価格とパッケージサイズ
• タンパク質含有量とカロリー
• ドルあたりのタンパク質比率
• 栄養情報のステータス

🔧 技術詳細

サーバーはいくつかの重要なコンポーネントで構成されています：

• MCPサーバー (server.py)：主要なMCPプロトコルの実装
• データモデル (models.py)：リクエスト/レスポンスのPydanticモデル
• スクレイパー (scraper.py)：異なる店舗のウェブスクレイピングロジック
• 栄養推定：商品名に基づく基本的な栄養情報の推定

📚 ドキュメント

現在の実装

この初期バージョンには以下が含まれています：

• ✅ 基本的なMCPサーバーのセットアップ
• ✅ Trader Joe'sの商品検索（現時点ではモックデータ）
• ✅ 商品名に基づく栄養推定
• ✅ ドルあたりのタンパク質計算
• ✅ エラーハンドリングとロギング

将来的な機能強化

• 実際のウェブスクレイピングの実装
• USDA FoodData Central APIとの統合
• 価格データのRedisキャッシュ
• 追加の店舗サポート（Safeway、Krogerなど）
• リアルタイムの在庫チェック
• 高度な栄養分析

🤝 コントリビューション

これは学習プロジェクトです。問題や機能強化のリクエストを自由に提出してください。

📄 ライセンス

MITライセンス