🚀 Alexa 购物清单管理器
本工具可让您无缝管理Alexa购物清单，能即时添加、删除和查看项目。通过MCP与Claude或Cursor等AI助手交互，实现与Alexa购物清单的本地通信。
🚀 快速开始
此工具能让您轻松管理Alexa购物清单，通过MCP与AI助手交互，实现与清单的本地通信。
⚠️ 重要提示
此工具需要手动身份验证和Cookie刷新。它使用通过手动登录过程提取的浏览器cookie，且Amazon会话会过期。您必须定期重新运行登录脚本（步骤5和6），当工具停止工作时。
✨ 主要特性
- 无缝管理Alexa购物清单，可即时添加、删除和查看项目。
- 通过MCP与AI助手交互，实现与Alexa购物清单的本地通信。
📦 安装指南
先决条件
- Python 3.10+
uv（安装：pip install uv或参见astral.sh/uv）- Docker及Docker Compose（或Docker Desktop）
- Google Chrome（用于登录脚本）
- Amazon账户（带有Alexa）
设置与运行
1. 克隆仓库
# git clone 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服务器。
- 找到您的MCP客户端配置文件（通常名为
mcp.json）。具体位置因客户端而异。 - 打开文件并在主
"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）。
- 保存
mcp.json文件。 - 重新启动您的MCP客户端。现在应该可以找到“Alexa Shopping List MCP”服务器。
🔧 技术细节
组件
- API服务器（src/api）：使用FastAPI的Docker容器与Alexa通信。
- MCP服务器（src/mcp）：本地脚本提供MCP工具，代理到API服务器。
- 登录脚本（src/auth）：用于通过Selenium进行手动登录和Cookie注入的本地脚本。
📄 许可证
文档未提及相关信息，故跳过该章节。
🤝 支持
喜欢这个工具？考虑支持开发者：
