Kroger MCPサーバー

Krogerの公開APIとClaudeを統合し、ミールプランの買い物リストをKrogerのカートに直接追加できるようにします。

ツール

Related MCP server: Tiv Taam MCP Server

セットアップ

ステップ 1 — Kroger Developer Portalでアプリを登録する

1. https://developer.kroger.com にアクセスします

2. Register App をクリックします

3. 以下を入力します:

   • App Name: Meal Plan Assistant (任意)

   • Redirect URI: http://localhost:8080/callback

   • Scopes: product.compact, cart.basic:write, profile.compact

4. Client ID と Client Secret をコピーします

ステップ 2 — 依存関係のインストール

cd kroger_mcp
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

ステップ 3 — 環境変数の設定

export KROGER_CLIENT_ID=your_client_id_here
export KROGER_CLIENT_SECRET=your_client_secret_here
export KROGER_REDIRECT_URI=http://localhost:8080/callback

これらをシェルプロファイル（~/.zshrc または ~/.bashrc）に追加して永続化します。

ステップ 4 — Claudeへの接続

ClaudeのMCP設定（Macの場合は通常 ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します:

{
  "mcpServers": {
    "kroger": {
      "command": "/path/to/kroger_mcp/venv/bin/python",
      "args": ["/path/to/kroger_mcp/server.py"],
      "env": {
        "KROGER_CLIENT_ID": "your_client_id",
        "KROGER_CLIENT_SECRET": "your_client_secret",
        "KROGER_REDIRECT_URI": "http://localhost:8080/callback"
      }
    }
  }
}

保存後、Claude Desktopを再起動してください。

初回利用 — OAuthログイン

Claudeに初めてカートへの商品追加を依頼すると:

1. ブラウザがKrogerのログインページを開きます

2. Krogerアカウントでログインします

3. リダイレクトURLをターミナルに貼り付けます

4. 完了 — トークンが ~/.kroger_mcp_tokens.json に保存されます

その後は、保存されたリフレッシュトークンを使用して、Claudeがバックグラウンドでカートに追加できるようになります。

使用例

接続が完了したら、Claudeに次のように話しかけることができます:

「近くのKroger店舗を探して、今週の買い物リストをカートに追加して」

Claudeは以下の処理を行います:

1. 郵便番号を使用して kroger_find_store を呼び出します

2. すべてのアイテムを指定して kroger_add_grocery_list を呼び出します

3. 追加されたもの、スキップされたもの、および発生した問題を報告します

セキュリティに関する注意点

• Client IDとSecretはあなた自身のものです（あなたのアカウントで登録されます）

• トークンはローカルの ~/.kroger_mcp_tokens.json に保存されます（権限: 600）

• サードパーティのコードは介在せず、Krogerの公式APIを直接呼び出します

• 必要に応じて kroger_clear_auth で保存されたすべてのトークンを削除できます

トラブルシューティング

「Missing environment variables」 — KROGER_CLIENT_ID と KROGER_CLIENT_SECRET を設定してください

「Authorization expired」 — 操作を再試行してください。サーバーが自動的にリフレッシュします

「No matching product found」 — 検索語を短くしてみてください（例: 「Private Selection Baby Spinach」ではなく「spinach」）

レート制限 (HTTP 429) — Krogerはリクエスト数を制限しています。30秒待ってから再試行してください