Kroger MCP 서버

Kroger의 공개 API를 Claude와 통합하여 식단 식료품 목록을 Kroger 장바구니에 직접 추가할 수 있습니다.

도구

Related MCP server: Tiv Taam MCP Server

설정

1단계 — Kroger 개발자 포털에 앱 등록

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").

Rate limits (HTTP 429) — Kroger는 요청 수를 제한합니다; 30초 대기 후 다시 시도하세요.