markswendsen-code/mcp-safeway

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

3 stars 8 forks 质量 61 趋势 14

Repository Install

MCP server for Safeway - let AI agents order groceries

概览

An MCP (Model Context Protocol) server connector for Safeway/Albertsons grocery delivery, powered by Playwright browser automation. This package provides an MCP server that enables AI assistants to interact with Safeway and Albertsons online grocery platforms. It uses Playwright to automate browser interactions, allowing you to search products, manage your cart, schedule deliveries, and place orders. Add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS): Log in to your Safeway/Albertsons account. List of products with IDs, names, prices, and availability. Get full details for a specific product. Full product info including description, brand, UPC, and pricing. All cart items with quantities, prices, subtotal, and estimated total.

README

以下为原文 README 节选，完整内容请查看原文。

@striderlabs/mcp-safeway

An MCP (Model Context Protocol) server connector for Safeway/Albertsons grocery delivery, powered by Playwright browser automation.

Overview

This package provides an MCP server that enables AI assistants to interact with Safeway and Albertsons online grocery platforms. It uses Playwright to automate browser interactions, allowing you to search products, manage your cart, schedule deliveries, and place orders.

Installation

From npm

npm install -g @striderlabs/mcp-safeway
npx playwright install chromium

From source

git clone https://github.com/markswendsen-code/mcp-safeway.git
cd mcp-safeway
npm install
npx playwright install chromium
npm run build

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "safeway": {
      "command": "striderlabs-mcp-safeway"
    }
  }
}

Other MCP Clients

Run the server directly:

striderlabs-mcp-safeway

Or with npx:

npx @striderlabs/mcp-safeway

Tools

Authentication

`safeway_login`

Parameter	Type	Required	Description
`email`	string	Yes	Your Safeway account email
`password`	string	Yes	Your Safeway account password

Example:

{
  "email": "[email protected]",
  "password": "your-password"
}

Products

`safeway_search_products`

Search for products on Safeway.

Parameter	Type	Required	Description
`query`	string	Yes	Search query (e.g., “organic milk”)
`category`	string	No	Filter by category (e.g., “produce”, “dairy”)
`filters`	object	No	Additional filters as key-value pairs

Example:

{
  "query": "organic whole milk",
  "category": "dairy"
}

Returns: List of products with IDs, names, prices, and availability.

`safeway_get_product_details`

Get full details for a specific product.

Parameter	Type	Required	Description
`product_id`	string	Yes	Product ID from search results

Returns: Full product info including description, brand, UPC, and pricing.

Cart Management

`safeway_add_to_cart`

Add a product to your cart.

Parameter	Type	Required	Description
`product_id`	string	Yes	Product ID to add
`quantity`	number	Yes	Number of items (minimum: 1)

`safeway_get_cart`

Retrieve current cart contents.

Returns: All cart items with quantities, prices, subtotal, and estimated total.

`safeway_update_cart_item`

Update the quantity of a cart item.

在 GitHub 查看完整 README

安装

npx playwright install chromium

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "safeway": {
      "command": "striderlabs-mcp-safeway"
    }
  }
}