sek-fx-mcp

sek-fx-mcp

スウェーデンクローナに対する通貨の為替レートを LLM が照会できる、Python で書かれた MCP サーバー（Model Context Protocol）です。

サーバーは Riksbank の API に接続し、通貨の最新の仲値（PMI）を取得します。ISO 4217 の通貨コードを受け付けます。たとえば、NOK（ノルウェークローネ）、EUR（ユーロ）、GBP（英ポンド）などです。応答は構造化されており、通貨 1 単位あたりの SEK 価格と、レートが公表された日付を示します。レートは銀行営業日に公表されるため、日付が今日より前になる場合があります。

Python 3.14 と uv が必要です。macOS の Claude Desktop でテスト済みです。

インストール

Claude Desktop：

uv run mcp install server.py

Claude Code：

claude mcp add sek-fx -- uv run --directory /sökväg/till/sek-fx-mcp server.py

uv run server.py を使ってサーバーを直接起動することもできます（stdio）。

API キー

API キーがない場合、Riksbank は同じ IP アドレスからのリクエスト数を制限します（1 分あたり 5 回、1 日あたり最大 1000 回）。キーがあれば、1 分あたり 200 回、1 週間あたり最大 30,000 回のリクエストが可能です。

キーの取得方法：

1. Riksbank の API ポータルにアクセスし、右上の Sign Up を選択して登録します。
2. Products タブに移動し、サブスクリプションを作成します。
3. キーは Profile タブに Primary key と Secondary key として表示されます。どちらでも使用できます。

テスト環境（developer.api-test.riksbank.se）と本番環境（developer.api.riksbank.se）では、キーが異なることにご注意ください。サーバーは本番環境を使用します。

キーを環境変数 RIKSBANKEN_API_KEY に設定すると、ヘッダー Ocp-Apim-Subscription-Key に送信されます：

uv run mcp install server.py -v RIKSBANKEN_API_KEY=<din-nyckel>
# eller
claude mcp add sek-fx -e RIKSBANKEN_API_KEY=<din-nyckel> -- uv run --directory /sökväg/till/sek-fx-mcp server.py

開発

uv run pytest          # tester, Riksbankens API mockas
uv run ruff check .
uv run ruff format .
uv run mcp dev server.py   # MCP Inspector

参考資料：

https://en.wikipedia.org/wiki/ISO_4217

https://github.com/modelcontextprotocol/python-sdk

https://www.riksbank.se/sv/statistik/rantor-och-valutakurser/hamta-rantor-och-valutakurser-via-api/

https://modelcontextprotocol.io/