posokanei-mcp

posokanei-mcp

PosoKanei のスーパーマーケット商品・価格データを扱う、非公式の読み取り専用 MCP サーバーです。

このサーバーを使うと、MCP 対応クライアントから次のような質問ができます。

• 商品名でスーパーマーケットの商品を検索する。
• バーコードで商品を検索する。
• 商品の現在の小売店価格を比較する。
• 少量の買い物かごを小売店間で比較する。
• 商品カテゴリや小売店を閲覧する。

ステータス

オープンソースとして公開された初期バージョンです。この実装では、PosoKanei のウェブアプリが使用する、公開されているものの文書化されていないエンドポイントを利用しています。リクエストは控えめにし、キャッシュに配慮してください。

このプロジェクトは、PosoKanei、gov.gr、またはギリシャの公的機関とは提携しておらず、承認も運営もされていません。

インストール

MCP クライアントの設定に追加してください。

{
  "mcpServers": {
    "posokanei": {
      "command": "npx",
      "args": ["-y", "posokanei-mcp"]
    }
  }
}

ローカルで開発する場合：

{
  "mcpServers": {
    "posokanei": {
      "command": "node",
      "args": ["/absolute/path/to/posokanei-mcp/dist/index.js"]
    }
  }
}

まずビルドしてください。

npm install
npm run build

ツール

ツール	目的
search_products	テキストで商品を検索します。
get_product	商品 ID の詳細と小売店価格を取得します。
lookup_barcode	EAN/GTIN バーコードから商品の価格を検索します。
list_products_by_category	カテゴリの商品を一覧表示します。デフォルトでは単価順に並べ替えます。
list_categories	簡易カテゴリツリーを返します。
list_retailers	登録されている小売店を一覧表示します。
get_price_history	利用可能な場合、価格履歴を含む商品詳細を取得します。
compare_competitors	利用可能な場合、比較対象・競合商品のデータを取得します。
compare_basket	少量の買い物かごを小売店間で比較します。
get_stats	データセットの概要統計を返します。

設定

任意の環境変数：

変数	デフォルト	目的
POSOKANEI_API_BASE	https://api.posokanei.gov.gr	API のベース URL。
POSOKANEI_CACHE_TTL_MS	300000	インメモリキャッシュの TTL。
POSOKANEI_MIN_INTERVAL_MS	250	外部 API リクエスト間の最小間隔。
POSOKANEI_TIMEOUT_MS	15000	リクエストのタイムアウト。

開発

npm install
npm run typecheck
npm test

テストスイートでは PosoKanei API をモックします。実際のネットワークアクセスは不要です。

ライセンス

MIT