Riksbank MCP

🚀 一個瑞典的貨幣政策數據服務器：Kolada MCP

本項目是一個非官方的 MCP（貨幣政策協議）服務器，旨在提供對瑞典央行（Sveriges Riksbank）數據的訪問途徑。用戶可藉助現代 API 和工具鏈，對瑞典央行的貨幣政策數據進行查詢與分析。

🚀 快速開始

該項目是一個非官方的 MCP 服務器，允許用戶通過現代 API 和工具鏈查詢和分析瑞典央行的貨幣政策數據。你可以按照以下步驟開始使用：

1. 完成安裝指南中的先決條件和安裝步驟。
2. 參考“作為庫使用”部分的代碼示例，將工具集成到你的項目中。
3. 若需與 Claude Desktop 集成，按照對應部分的說明編輯配置文件。

✨ 主要特性

• 現代 API：基於 Python 的異步設計，提供簡潔高效的接口。
• 類型安全：藉助 Python 的類型系統（如 typing.TypeAlias），保障代碼的安全性與可維護性。
• 容器化支持：通過 Docker 實現一鍵式部署，便於集成和管理依賴。
• 開發工具鏈：集成了包括 uv 在內的多種工具，簡化了從開發到測試的流程。

📦 安裝指南

先決條件

• Python 版本 3.12 或更高
• Astral 的 uv 工具 版本 0.2.0 或更高

使用 uv sync 進行安裝

uv sync

此命令會安裝項目的所有生產及開發依賴項，創建虛擬環境（若有需要），並鎖定所有依賴項的精確版本，確保每個貢獻者或 CI 管道使用相同的依賴棧。

💻 使用示例

與 Claude Desktop 的集成

編輯你的 claude_desktop_config.json 文件以添加 Kolada MCP Server：

Docker 鏡像（本地構建）

"SwemoMCP": {
  "args": [
    "run",
    "-i",
    "--rm",
    "--name",
    "swemo-mcp-managed",
    "swemo-mcp:local"
  ],
  "command": "docker",
  "env": {}
}

預構建容器（通過 PyPI）

"SwemoPyPI": {
  "args": ["swemo-mcp"],
  "command": "/Users/hugi/.cargo/bin/uvx"
}

本地 UV 執行（無需 Docker）

將 [path to kolada-mcp] 替換為你的實際路徑：

"SwemoLocal": {
  "args": [
    "--directory",
    "[path to kolada-mcp]/src/kolada_mcp",
    "run",
    "kolada-mcp"
  ],
  "command": "uv"
}

更新完成後重啟 Claude Desktop。

作為庫使用

import asyncio
from swemo_mcp.tools import get_policy_rate_data

async def main():
    from swemo_mcp.query import ForecastRequest
    req = ForecastRequest(policy_round="2023:4", include_realised=True)
    data = await get_policy_rate_data(req)
    print(data.vintages[0].observations[:5])  # 打印前5個觀察結果

asyncio.run(main())

由於一切都是有類型的且是異步的，你可以直接將工具集成到筆記本、儀表盤或其他服務中。

Docker 支持

項目提供了多階段的 Dockerfile，在最終層使用 uv，因此容器構建能夠受益於確定性的依賴項分辨率。

docker build -t swemo-mcp:latest .

docker run -i --rm swemo-mcp:latest | mcp chat

如果你在開發過程中更喜歡使用 Docker Compose，一個示例 compose.yaml 文件展示瞭如何掛載源目錄並實現熱重新加載。

📚 詳細文檔

開發指南

1. 設置環境

uv sync --dev

2. 以開發模式運行服務器，並啟用即時重載（需要安裝 mcp dev）：

uv run mcp dev src/swemo_mcp/server.py

3. 打開 MCP 監視器 以測試和調試： http://localhost:5173
4. 運行測試套件（使用 pytest 和 asyncio）：

uv run pytest -q

5. 格式化與檢查代碼 自動使用 Ruff：

uv run ruff check . --fix

📄 許可證

項目在 Apache 2.0 許可證下發布。完整的許可文本可在 文件中找到。

⚠️ 免責聲明

• 這是一個 非官方 的 MCP 服務器，用於訪問 Sveriges Riksbank 的數據。底層 API 可能會更改，該項目可能無法始終反映最新的更新。
• Sveriges Riksbank 對此項目的開發沒有任何參與。提供的數據“按現狀”提供，不附帶任何形式的保證。
• 所有錯誤和不準確之處均為作者的責任，並歡迎任何反饋或修正。