kronan-mcp

kronan-mcp

Krónan の食料品店 API 用 MCP サーバーです。Claude は、アイスランドにある Krónan の Snjallverslun（スマートストア）で、商品を検索したり、買い物メモを管理したり、チェックアウトを処理したり、注文を追跡したりできます。

ツール

Model Context Protocol を通じて利用できる 25 個のツールです。

カテゴリ	ツール
商品	search_products, get_product, get_category_products, list_categories
チェックアウト	get_checkout, add_checkout_lines
注文	list_orders, get_order, delete_order_lines, set_order_substitution, lower_order_quantity
買い物メモ	get_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
商品リスト	list_product_lists, create_product_list, get_product_list, update_product_list, delete_product_list, clear_product_list, sort_product_list, update_product_list_item
購入統計	list_purchase_stats, set_purchase_stat_ignored
アカウント	get_me

インストール

npm install -g kronan-mcp

または、npx で直接実行できます（インストール不要）。

npx kronan-mcp

トークンの取得

トークンは Krónan Snjallverslun のユーザー設定で作成します。Audkenni（アイスランドの電子 ID）でログインできるアカウントが必要です。ユーザー設定または顧客グループ設定のページに移動し、アクセストークンを作成してください。トークンには act_ のプレフィックスが付きます。

Claude Code での使用方法

プロジェクトの .claude/settings.local.json またはグローバル設定の ~/.claude/settings.json に追加します。

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

その後、Claude に次のように依頼できます。

• 「Krónan で牛乳を検索して」
• 「買い物メモには何が入っている？」
• 「SKU 02500188 を 2 個チェックアウトに追加して」
• 「最近の注文を表示して」

アーキテクチャ

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

すべてのリクエストで Authorization: AccessToken <token> を使用して認証します。レート制限はユーザーごとに 200 秒あたり 200 リクエストです。クライアントは 429 レスポンスを検出し、呼び出し元に待機するよう伝えます。

すべての価格は ISK の整数（小数なし）です。230 は 230 kr を意味します。

エラーは、ステータスコードを持つ型付きの KronanApiError を介して処理されます。LLM にトークンが漏れないよう、エラーメッセージからトークンを除去します。認証エラーとレート制限には、それぞれ専用のユーザー向けメッセージが表示されます。

set_order_substitution と set_line_completion は、読み取り後に切り替えるパターンを使用します。これらは冪等ではありません。タイムアウト時に再試行する前に、必ず現在の状態を確認してください。

API リファレンス

完全な OpenAPI スキーマは openapi-schema.yaml にあります。

開発

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

テスト

HTTP クライアントのテストが 31 件あります。コンストラクターの検証、エラー処理（429、タイムアウト、JSON 解析の失敗）、トークンの除去、切り替えメソッドの検証、対象資格エンドポイントのエッジケースを網羅しています。

npm test