AI导哈

Alexa购物清单管理服务

基于Model Context Protocol和alexa-remote2库的Alexa购物清单管理服务，支持通过MCP客户端管理Alexa购物清单。

  • by GraysonCAdams
  • 本地部署
  • 更新于
在 GitHub 查看 GraysonCAdams/alexa-mcp

使用说明

亚历克斯mcp

亚马逊Alexa的MCP服务器——从任何MCP客户端（克劳德等）管理您的Alexa购物清单。

建立在 模型上下文协议 和那个 alexa-remote2 图书馆。

工具

工具 说明
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.js

HTTP模式（通过mcp代理）

mcp-proxy --port 8005 -- node dist/index.js

Claude桌面配置

将此添加到您的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)这提高了亚马逊用户数据端点返回意外响应时的弹性。

许可证

麻省理工学院——见 许可证.

相关 MCP