使用说明
sek-fx-mcp
En MCP-server (Model Context Protocol) skriven i Python som låter en LLM slå upp växlingskursen för en valuta mot svenska kronor.
Servern kontaktar Riksbankens API och hämtar senaste mittkurs (PMI) för en valuta. Den accepterar ISO 4217-koden för valutor dvs NOK (norska kronor), EUR (Euro), GBP (brittiska pund) etc. Svaret är strukturerat och anger priset i SEK för en enhet av valutan samt vilket datum kursen publicerades. Kurser publiceras bankdagar, så datumet kan vara tidigare än dagens.
Kräver Python 3.14 och uv. Testad i Claude Desktop i macOS.
Installation
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
Servern kan också startas direkt (stdio) med uv run server.py.
API-nyckel
Utan API-nyckel begränsar Riksbanken antalet anrop från samma ip-adress (5 anrop per minut och maximalt 1000 anrop per dygn). Med en nyckel kan du göra 200 anrop per minut, med ett tak på 30 000 anrop per vecka.
Så skaffar du en nyckel:
- Gå till Riksbankens API-portal, välj Sign Up uppe till höger och registrera dig.
- Gå till fliken Products och skapa en subscription.
- Nycklarna visas under fliken Profile som Primary och Secondary key. Du kan använda vilken som helst av dem.
Observera att testmiljön (developer.api-test.riksbank.se) och produktionsmiljön (developer.api.riksbank.se) har olika nycklar. Servern använder produktionsmiljön.
Sätt nyckeln i miljövariabeln RIKSBANKEN_API_KEY, så skickas den i headern 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
Utveckling
uv run pytest # tester, Riksbankens API mockas
uv run ruff check .
uv run ruff format .
uv run mcp dev server.py # MCP Inspector
Vidare läsning:
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/