Kronan Mcp

io.github.sandsower由 GitHub 帳號 sandsower 發布v1.0.1更新於 Oct 24, 2026

MCP server for the Krónan grocery store API (Iceland)

已驗證STDIO僅桌面效率與工作流商業與電商

概覽

AI 產生的概覽

針對冰島 Krónan 超市 API 的在地 MCP 伺服器，讓助理搜尋商品、管理購物清單與商品清單，並處理結帳和訂單。

可以做什麼
搜尋與讀取 Krónan 智慧商店目錄中的商品、商品詳情和分類，價格以 ISK 整數表示。管理購物備註：新增、修改、重新排序、刪除和完成項目，清空備註，並檢查門市下單資格。管理商品清單：建立、讀取、更新、刪除、清空、排序和編輯清單項目。處理結帳與訂單：查看結帳、新增結帳項目、列出和讀取訂單、刪除訂單項目、設定替代商品和降低數量。查看購買統計和帳戶資訊。
適用情境
適合在冰島擁有 Krónan Snjallverslun 帳戶、希望藉助助理規劃日常採買、整理或修改購物備註和商品清單，並透過對話查看或調整訂單的使用者。
執行需求
透過 npm（kronan-mcp）或 npx 以 stdio 在本機執行，需要 Node.js。需要 Krónan Snjallverslun 帳戶並以 Audkenni 電子身分登入，還需在使用者或客戶群組設定中建立以 act_ 開頭的存取權杖，透過環境變數 KRONAN_ACCESS_TOKEN 提供。需要連線至 Krónan API 的網路。
安裝前請注意
KRONAN_ACCESS_TOKEN 是與真實購物帳戶綁定的密鑰，請勿放入共用設定檔。許多工具會寫入或刪除資料，包括結帳項目、訂單項目、購物備註和商品清單，部分操作可能影響真實訂單。set_order_substitution 和 set_line_completion 不具冪等性，逾時後不要直接重試，應先確認目前狀態。請求速率限制為每 200 秒 200 次。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Kronan Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

kronan-mcp

MCP server for the Krónan grocery store API. Claude can browse products, manage shopping notes, handle checkout, and track orders from Krónan's Snjallverslun (smart store) in Iceland.

Tools

25 tools over the Model Context Protocol:

CategoryTools
Productssearch_products, get_product, get_category_products, list_categories
Checkoutget_checkout, add_checkout_lines
Orderslist_orders, get_order, delete_order_lines, set_order_substitution, lower_order_quantity
Shopping notesget_shopping_note, add_shopping_note_line, change_shopping_note_line, reorder_shopping_note_lines, delete_shopping_note_line, set_line_completion, clear_shopping_note, check_store_order_eligibility, apply_store_product_order, list_archived_lines, delete_archived_line
Product listslist_product_lists, create_product_list, get_product_list, update_product_list, delete_product_list, clear_product_list, sort_product_list, update_product_list_item
Purchase statslist_purchase_stats, set_purchase_stat_ignored
Accountget_me

Install

bash
npm install -g kronan-mcp

Or run directly with npx (no install needed):

bash
npx kronan-mcp

Getting a token

Tokens are created in the Krónan Snjallverslun user settings. You need an account with Audkenni (Iceland's electronic ID) login. Go to your user or customer group settings page and create an access token. Tokens are prefixed with act_.

Usage with Claude Code

Add to your project's .claude/settings.local.json or global ~/.claude/settings.json:

json
{  "mcpServers": {    "kronan": {      "command": "npx",      "args": ["kronan-mcp"],      "env": {        "KRONAN_ACCESS_TOKEN": "act_your_token_here"      }    }  }}

Then ask Claude things like:

  • "Search for milk on Krónan"
  • "What's in my shopping note?"
  • "Add 2x of SKU 02500188 to my checkout"
  • "Show my recent orders"

Architecture

src/├── client.ts   HTTP client wrapping all Krónan API endpoints├── index.ts    MCP server registering tools via @modelcontextprotocol/sdk└── types.ts    TypeScript interfaces matching the OpenAPI schema

Auth is Authorization: AccessToken <token> on every request. Rate limit is 200 requests per 200 seconds per user. The client detects 429 responses and tells the caller to wait.

All prices are integers in ISK (no decimals). 230 means 230 kr.

Errors go through a typed KronanApiError with status codes. The token is scrubbed from error messages so it doesn't leak to the LLM. Auth failures and rate limits get their own user-facing messages.

set_order_substitution and set_line_completion use read-then-toggle patterns. They're not idempotent. Don't retry on timeout without checking current state first.

API reference

Full OpenAPI schema at openapi-schema.yaml.

Development

bash
npm install && npm run build   # Build from sourcenpm run dev                    # Watch mode (recompiles on change)npm test                       # Run testsnpm run test:watch             # Watch mode tests

Tests

31 tests on the HTTP client: constructor validation, error paths (429, timeouts, JSON parse failures), token scrubbing, toggle method validation, eligibility endpoint edge cases.

bash
npm test

來源：README.md，提交 ba8ec21

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分