fireball1725/pcexpress-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

11 stars 4 forks 品質 82 トレンド 22AGPL-3.0

Repository Install

AI-powered grocery cart control for PC Express/Loblaws stores via Model Context Protocol (MCP)

概要

Model Context Protocol (MCP) server for PC Express / Loblaws grocery shopping Control your grocery cart with AI! This MCP server enables LLMs (like Claude) to search past orders, find products, and manage your shopping cart across all Loblaws-owned grocery banners. the login sits behind Akamai bot detection, so the OAuth flow was reverse-engineered out of Loblaw's Android app. If you want the emulator-and-mitmproxy story behind pcid_config.py, read the write-up: Reverse-engineering PC Express. - : This project is NOT affiliated with, endorsed by, or supported by Loblaws Companies Limited, PC Express, or any related entities - : This uses an undocumented API that may change without notice - : See LICENSE for details - : This project demonstrates API reverse engineering and MCP server development Works with all PC Express enabled stores: - - Ontario-based grocery chain - - Main flagship banner - - Discount grocery banner - - Western Canada supermarket - - Franchise stores - - Asian...

README

以下は原文 README の抜粋です。原文を見る。

PC Express MCP Server

Unofficial Model Context Protocol (MCP) server for PC Express / Loblaws grocery shopping

Control your grocery cart with AI! This MCP server enables LLMs (like Claude) to search past orders, find products, and manage your shopping cart across all Loblaws-owned grocery banners.

How the auth was cracked: the login sits behind Akamai bot detection, so the OAuth flow was reverse-engineered out of Loblaw’s Android app. If you want the emulator-and-mitmproxy story behind pcid_config.py, read the write-up: Reverse-engineering PC Express.

⚠️ Important Disclaimers

Unofficial: This project is NOT affiliated with, endorsed by, or supported by Loblaws Companies Limited, PC Express, or any related entities
Use at Your Own Risk: This uses an undocumented API that may change without notice
No Warranty: See LICENSE for details
Educational Purpose: This project demonstrates API reverse engineering and MCP server development

🛒 Supported Grocery Banners

Works with all PC Express enabled stores:

Zehrs - Ontario-based grocery chain
Loblaws - Main flagship banner
No Frills - Discount grocery banner
Real Canadian Superstore - Western Canada supermarket
Your Independent Grocer - Franchise stores
T&T Supermarket - Asian specialty supermarket

✨ Features

MCP Tools (6)

search_past_orders - Find items from your order history
get_order_items - Get detailed product list from specific orders
search_products - Search the product catalog
add_to_cart - Add products to your shopping cart
remove_from_cart - Remove items from cart
view_cart - See current cart contents

Integration Ready

✅ Home Assistant - Voice-controlled grocery shopping
✅ Claude Desktop - Chat with your grocery list
✅ Custom Clients - Any MCP-compatible application

Voice Assistant Examples

🎤 "Add ice cream to my grocery cart"
🎤 "What did I order last week?"
🎤 "Search for organic bananas"
🎤 "What's in my cart?"

🚀 Quick Start

Prerequisites

Python 3.10 or higher
Active account with a PC Express enabled banner
pip or pip3

Installation

Clone the repository

git clone https://github.com/FireBall1725/pcexpress-mcp-server.git
cd pcexpress-mcp-server

Install dependencies
```
pip install -r requirements.txt
```

Configure credentials

cp .env.example .env
# Edit .env with your credentials (see Configuration section)

Test the connection
```
python test_api.py
```
Run the server

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "pcexpress": {
      "command": "python3",
      "args": ["/path/to/pcexpress_mcp_server.py"],
      "env": {
        "PCEXPRESS_REFRESH_TOKEN": "your_refresh_token",
        "PCEXPRESS_STATE_DIR": "~/.pcexpress-mcp",
        "PCEXPRESS_STORE_ID": "your_store",
        "PCEXPRESS_BANNER": "zehrs"
      }
    }
  }
}