# mcp-amazon

`mcp-amazon` is a read-only, source-scoped MCP server for Amazon wishlist data.

Version `0.1.0` supports two read paths:

- HTML snapshot parsing for stable, low-risk reads
- optional live browser-backed reads with an operator-supplied storage state

It follows the shared source conventions documented in `mcp-source-playbook` and `mcp-source-foundation`.

## Implemented

- MCP stdio server via `mcp-amazon-server`
- profile and health reporting
- wishlist reads through `amazon_wishlist_items`
- focused unit tests for parsing and profile behavior

## Tools

- `amazon_profile`
- `amazon_health`
- `amazon_wishlist_items`

## Configuration

Use either a saved HTML snapshot or a wishlist ID:

```bash
export AMAZON_WISHLIST_HTML_PATH="/path/to/wishlist.html"
export AMAZON_WISHLIST_ID="wishlist-id"
export AMAZON_STORAGE_STATE="/path/to/storage-state.json"
export AMAZON_DOMAIN="www.amazon.co.jp"
```

## CLI

```bash
mcp-amazon profile --format json
mcp-amazon wishlist --format json
mcp-amazon-server
```

## Safety

- read-only by default
- write and account-changing operations are not implemented in v1
- live browser reads are opt-in and require operator-managed session state

## Development

```bash
python -m pytest
```