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 注入的本地腳本。

📄 支持

喜歡這個工具？考慮支持開發者：