亚历克斯mcp
亚马逊Alexa的MCP服务器——从任何MCP客户端（克劳德等）管理您的Alexa购物清单。
工具
| 工具 | 说明 |
|---|---|
authenticate | 使用您的亚马逊帐户进行身份验证。如果可用，则使用保存的cookie，否则启动浏览器登录代理并返回要打开的URL。 |
list_items | 从Alexa购物清单中获取商品。可选地包括已完成的项目。 |
add_items | 将一个或多个项目添加到您的Alexa购物清单中。 |
delete_items | 按名称从Alexa购物清单中删除项目（不区分大小写匹配）。 |
update_item | 更新购物清单上的项目——重命名和/或更改其完成状态。 |
complete_items | 按名称在Alexa购物清单上将商品标记为已完成（不区分大小写匹配）。 |
check_status | 检查服务器是否经过身份验证，并显示当前配置。 |
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
COOKIE_PATH | ~/.alexa-mcp/cookie.json | 持久Alexa身份验证cookie的路径 |
AMAZON_PAGE | amazon.com | 要进行身份验证的亚马逊域 |
PROXY_PORT | 3001 | 浏览器登录代理的端口（在初始身份验证期间使用） |
ALEXA_COOKIE | -- | 预种子cookie JSON（替代 COOKIE_PATH 文件） |
设置
npm ci用法
标准模式（直接）
node dist/index.jsHTTP模式（通过mcp代理）
mcp-proxy --port 8005 -- node dist/index.jsClaude桌面配置
将此添加到您的Claude Desktop MCP配置中：
{
"mcpServers": {
"alexa": {
"command": "node",
"args": ["/path/to/alexa-mcp/dist/index.js"],
"env": {
"COOKIE_PATH": "/path/to/cookie.json"
}
}
}
}认证
在第一次运行中 authenticate 该工具启动本地代理服务器。在浏览器中打开返回的URL并登录您的亚马逊帐户。cookie保存到 COOKIE_PATH 并在后续会话中重复使用。
如果您已经有一个cookie（例如，来自前一个会话或另一台机器），您可以：
- 将JSON文件放在
COOKIE_PATH - 设置
ALEXA_COOKIE包含JSON内容的环境变量
补丁
此项目包括一个补丁 alexa-cookie2 （通过自动应用 patch-package 上 npm ci)这提高了亚马逊用户数据端点返回意外响应时的弹性。
许可证
麻省理工学院——见 许可证.