English Français العربية

io.github.SlambertDK/shelfatlas-catalog

السجل الرسمي المالية والمدفوعات

Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http shelfatlas-catalog 'https://api.shelfatlas.com/api/v1/mcp' --header 'Authorization: <Bearer sa_live_<your-key> — create a free key at https://app.shelfatlas.com>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "shelfatlas-catalog": {
            "type": "http",
            "url": "https://api.shelfatlas.com/api/v1/mcp",
            "headers": {
                "Authorization": "<Bearer sa_live_<your-key> — create a free key at https://app.shelfatlas.com>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ShelfAtlas MCP server
  2. Tools
  3. Claude Desktop
  4. Run locally (stdio)

ShelfAtlas MCP server

Danish grocery catalog and shelf data as MCP tools. Ask "where is Pepsi Max cheapest right now?" and get live, structured answers: current offers across every major Danish chain, nearest-store geo search, product name and EAN lookup, and a purpose-built find_cheapest_offers tool. Community shelf-stock signals are included where approved, with confirmation counts.

Tools

ToolWhat it answers
search_productsResolve a product name to id + EAN before calling other tools
get_product_by_eanLook up a product by EAN-13 barcode
find_cheapest_offers"Where is this product cheapest right now?" — live offers, cheapest first, chain resolved
search_catalog_offersCatalog offers with price and validity window (live-only by default; chain/EAN/product filters)
get_storesPaginated store list, or nearest-first geo search
list_chainsAll retail chains (id, slug, name)

Claude Desktop

Claude Desktop reaches remote servers through 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>"
      }
    }
  }
}

Clients with native Streamable HTTP support connect directly to the endpoint with the Authorization header.

Run locally (stdio)

For clients that only speak stdio, this repository is also a small local server that serves the hosted tools over 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

Or with Docker: docker build -t shelfatlas-mcp . and docker run -i --rm -e SHELFATLAS_API_KEY=sa_live_<your-key> shelfatlas-mcp.

Listing the tools works without a key; calling them needs SHELFATLAS_API_KEY. server.json is the manifest for the official MCP registry.

الأسئلة الشائعة

ما هو io.github.SlambertDK/shelfatlas-catalog؟

Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.

كيف أثبّت io.github.SlambertDK/shelfatlas-catalog؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http shelfatlas-catalog 'https://api.shelfatlas.com/api/v1/mcp' --header 'Authorization: <Bearer sa_live_<your-key> — create a free key at https://app.shelfatlas.com>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.SlambertDK/shelfatlas-catalog إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.SlambertDK/shelfatlas-catalog مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.SlambertDK/shelfatlas-catalog؟

ينشره SlambertDK. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.