shelfatlas-catalog

ShelfAtlas MCP 服务

将丹麦的杂货目录和货架数据作为 MCP 工具提供。询问 “现在 Pepsi Max 哪里最便宜？”，即可获得实时结构化答案：丹麦各大连锁店的当前优惠、附近门店地理搜索、商品名称和 EAN 查询，以及专门打造的 find_cheapest_offers 工具。经批准后，还会提供社区货架库存信息，并附上确认数量。

• 端点： https://api.shelfatlas.com/api/v1/mcp（Streamable HTTP）
• 身份验证： Authorization: Bearer sa_live_<your-key> — 在 https://app.shelfatlas.com 创建免费密钥
• 文档： https://shelfatlas.com/docs（工具、配额、错误代码）

工具

工具	可回答的问题
search_products	将商品名称解析为 id + EAN，然后再调用其他工具
get_product_by_ean	通过 EAN-13 条形码查询商品
find_cheapest_offers	“这个商品现在在哪里最便宜？”——实时优惠，按价格从低到高排序，并解析连锁店
search_catalog_offers	查询目录优惠及价格和有效期（默认仅实时优惠；可按连锁店/EAN/商品筛选）
get_stores	分页列出门店，或按距离由近到远进行地理搜索
list_chains	所有零售连锁店（id、slug、名称）

Claude Desktop

Claude Desktop 通过 mcp-remote 连接远程服务：

{
  "mcpServers": {
    "shelfatlas": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.shelfatlas.com/api/v1/mcp"],
      "env": {
        "MCP_REMOTE_HEADER_AUTHORIZATION": "Bearer sa_live_<your-key>"
      }
    }
  }
}

支持原生 Streamable HTTP 的客户端可通过 Authorization 标头直接连接到端点。

本地运行（stdio）

对于仅支持 stdio 的客户端，本仓库还提供了一个小型本地服务，可通过 stdio 提供托管工具（Node.js 20+）：

git clone https://github.com/SlambertDK/shelfatlas-mcp && cd shelfatlas-mcp
npm ci
SHELFATLAS_API_KEY=sa_live_<your-key> node index.js

也可以使用 Docker：docker build -t shelfatlas-mcp .，然后运行 docker run -i --rm -e SHELFATLAS_API_KEY=sa_live_<your-key> shelfatlas-mcp。

无需密钥即可列出工具；调用工具则需要设置 SHELFATLAS_API_KEY。 server.json 是 MCP 官方注册表的清单。