Texas Grocery MCP

🛒 得克萨斯州杂货MCP

](https://pypi.org/project/texas-grocery-mcp/)  

🤖 让AI帮你买杂货！连接克劳德和H-E-B杂货店的MCP服务器。

搜索产品、管理购物车、剪辑优惠券等等——所有这些都是通过自然对话完成的。

⚠️ 这个项目是 不属于H-E-B。它使用非官方的web API和浏览器自动化来对抗HEB.com；负责任地使用，并确保您的使用符合适用的条款和法律。

______________________________________________________________________

✨ 特性

______________________________________________________________________

📦 安装

快速开始

pip install texas-grocery-mcp

完整安装（推荐）🚀

pip install texas-grocery-mcp[browser]
playwright install chromium

这使得 快速自动刷新 （约15秒）使用嵌入式浏览器。

先决条件

对于购物车操作和会话管理，您还需要 剧作家MCP:

npm install -g @anthropic-ai/mcp-playwright

______________________________________________________________________

⚙️ 配置

克劳德桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@anthropic-ai/mcp-playwright"]
    },
    "heb": {
      "command": "uvx",
      "args": ["texas-grocery-mcp"],
      "env": {
        "HEB_DEFAULT_STORE": "590"
      }
    }
  }
}

环境变量

______________________________________________________________________

🎯 用法示例

🏪 寻找店铺

User: Find HEB stores near Austin, TX

Agent uses: store_search(address="Austin, TX", radius_miles=10)

🔍 搜索产品

User: Search for organic milk

Agent uses: store_change(store_id="590")
Agent uses: product_search(query="organic milk")

📋 获取产品详细信息

User: What are the ingredients in H-E-B olive oil?

Agent uses: product_search(query="heb olive oil")
Agent uses: product_get(product_id="127074")
# Returns: ingredients, nutrition facts, warnings, dietary attributes

这 product_get 工具返回：

• 🥗 配料 -完整成分说明
• 📊 营养成分表 -完整的FDA小组
• ⚠️ 安全警告 -过敏原信息和预防措施
• 🌿 饮食属性 -无麸质、有机、纯素、犹太洁食等。
• 📍 存储位置 -过道或区间

🛒 添加到购物车

User: Add 2 gallons of milk to my cart

Agent uses: cart_add(product_id="123456", quantity=2)
# Returns preview for confirmation

Agent uses: cart_add(product_id="123456", quantity=2, confirm=true)
# ✅ Added to cart!

🎟️ 剪贴优惠券

User: Find coupons for cereal

Agent uses: coupon_search(query="cereal")
Agent uses: coupon_clip(coupon_id="ABC123", confirm=true)
# ✅ Coupon clipped!

______________________________________________________________________

🔐 会话管理

HEB使用机器人检测，每11分钟过期一次。这个MCP会自动处理它！

⚡ 快速自动刷新（推荐）

随着 [browser] 已安装支架：

Agent uses: session_refresh()
# ✅ Completes in ~10-15 seconds

🔑 自动登录

保存一次凭据以自动登录：

Agent uses: session_save_credentials(email="you@email.com", password="...")
# Credentials stored securely in system keyring
# Future session refreshes will auto-login!

______________________________________________________________________

🧰 可用工具

🏪 存储工具

🔍 产品工具

🛒 购物车工具

🎟️ 优惠券工具

🔐 会话工具

______________________________________________________________________

📚 文档

• 🔧 故障排除指南 -常见问题的解决方案
• 🤝 贡献 -如何做出贡献
• 📝 更新日志 -版本历史
• 🔒 安全 -安全策略

______________________________________________________________________

🛠️ 发展

# Clone repository
git clone https://github.com/mgwalkerjr95/texas-grocery-mcp
cd texas-grocery-mcp

# Install with dev dependencies
pip install -e ".[dev]"
playwright install chromium

# Run tests
pytest tests/ -v

# Linting & type checking
ruff check src/
mypy src/

🐳 码头工人

docker-compose up --build

______________________________________________________________________

🏗️ 建筑

┌─────────────────────────────────────────────────────────────┐
│                    User's MCP Environment                    │
│                                                             │
│  ┌─────────────────────┐    ┌─────────────────────────────┐ │
│  │  🎭 Playwright MCP  │    │   🛒 Texas Grocery MCP      │ │
│  │  (Browser Auth)     │───▶│   (Grocery Logic)           │ │
│  └─────────────────────┘    └─────────────────────────────┘ │
│                                        │                     │
└────────────────────────────────────────┼─────────────────────┘
                                         │
                                         ▼
                                   🌐 HEB GraphQL API

______________________________________________________________________

📄 许可证

麻省理工学院©迈克尔·沃克

______________________________________________________________________

Made with ❤️ in Texas 🤠