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 分