Alexa Shopping List

🚀 Alexa 购物清单管理器

本项目可让您无缝管理 Alexa 购物清单，支持立即添加、删除和查看项目。通过 MCP 与 AI 助手（如 Claude 或 Cursor）交互，能使用此工具与 Alexa 购物清单进行本地通信。

🚀 快速开始

本工具可让您无缝管理 Alexa 购物清单，支持立即添加、删除和查看项目。通过 MCP 与 AI 助手（如 Claude 或 Cursor）交互，能使用此工具与 Alexa 购物清单进行本地通信。

⚠️ 重要提示

此工具需要手动身份验证和 Cookie 刷新。它使用通过手动登录过程提取的浏览器 cookie，而 Amazon 会话会过期，您必须定期重新运行登录脚本（步骤 5 和 6），当工具停止工作时。

✨ 主要特性

• 无缝管理 Alexa 购物清单，可立即添加、删除和查看项目。
• 支持通过 MCP 与 AI 助手（如 Claude 或 Cursor）交互，实现与 Alexa 购物清单的本地通信。

📦 安装指南

先决条件

• Python 3.10+
• uv（安装：pip install uv 或参见astral.sh/uv）
• Docker 及 Docker Compose（或 Docker Desktop）
• Google Chrome（用于登录脚本）
• Amazon 账户（带有 Alexa）

设置与运行

1. 克隆仓库

# git clone <repository_url>
cd alexa-mcp

2. 配置设置 编辑src/auth/config.py以反映您的 Amazon 凭证：

AMAZON_EMAIL = "你的亚马逊邮箱"
AMAZON_PASSWORD = "你的亚马逊密码"

3. 安装依赖项 在项目的根目录中运行以下命令：

pip install -r src/api/requirements.txt
pip install -r src/auth/requirements.txt
pip install -r src/mcp/requirements.txt

4. 启动 API 服务器 从项目根目录运行以下命令：

uvicorn src.api.main:app --reload

默认情况下，API 将在http://localhost:8000上可用。 5. 启动 MCP 服务器 从项目根目录运行以下命令：

uvicorn src.mcp.mcp_server:app --reload

连接 MCP 客户端（Claude Desktop / Cursor）

要将此服务器与 MCP 客户端（如 Claude Desktop 或 Cursor）一起使用，需要在客户端的mcp.json文件中添加其配置。此文件告诉客户端如何找到和运行您的本地 MCP 服务器。

1. 找到您的 MCP 客户端配置文件（通常名为mcp.json）。具体位置因客户端而异。
2. 打开文件并在主"mcpServers": { ... }对象内添加以下条目：

    "alexa-shopping-list": {
        "displayName": "Alexa Shopping List MCP",
        "description": "MCP Server for interacting with Alexa shopping list via local API",
        "command": "/path/to/your/alexa-mcp/.venv/bin/python",
        "args": [
          "-m",
          "src.mcp.mcp_server"
        ],
        "workingDirectory": "/path/to/your/alexa-mcp",
        "env": {
          "PYTHONPATH": "/path/to/your/alexa-mcp"
        }
    }

重要注意事项：

• 必须将占位符绝对路径/path/to/your/alexa-mcp替换为您计算机上项目的实际绝对路径。
• 确保.venv虚拟环境存在于该位置，并且已安装 MCP 依赖项（运行uv pip install -r src/mcp/requirements.txt）。

3. 保存mcp.json文件。
4. 重新启动您的 MCP 客户端。现在应该可以找到“Alexa Shopping List MCP”服务器。

🔧 技术细节

组件

1. API 服务器（src/api）：使用 FastAPI 的 Docker 容器与 Alexa 通信。
2. MCP 服务器（src/mcp）：本地脚本提供 MCP 工具，代理到 API 服务器。
3. 登录脚本（src/auth）：用于通过 Selenium 进行手动登录和 Cookie 注入的本地脚本。

📄 支持

喜欢这个工具？考虑支持开发者：