Swemo MCP

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

這是一個為瑞典央行（Riksbank）的數據創建的 Model Context Protocol (MCP) 服務器，允許通過一致且強大的接口訪問瑞典央行的貨幣政策數據，為開發者提供了便捷獲取數據的途徑。

🚀 快速開始

這是一個為瑞典央行（Riksbank）的數據創建的 Model Context Protocol (MCP) 服務器，它提供了便捷的方式來訪問瑞典央行的貨幣政策數據。以下是快速開始使用該服務器的步驟：

1. 確保滿足安裝的先決條件，克隆並設置項目。
2. 根據需求選擇與Claude Desktop集成的方式或作為庫使用。
3. 若在開發環境中，可按照開發步驟進行設置和運行。

✨ 主要特性

• 豐富的數據系列：提供大約30個不同貨幣政策相關數據系列。
• 靈活的時間序列訪問：支持指定具體的時間序列版本（政策週期），或獲取完整的歷史數據。
• 便捷的集成方式：集成方便，可以直接在Python代碼中使用，也可以通過Docker容器運行。

📦 安裝指南

⚠️ 重要提示

• Python ≥ 3.12 (使用 typing.TypeAlias/PEP 604 聯合)
• Astral uv ≥ 0.2.0

克隆並設置項目只需一個命令:

uv sync

uv sync 安裝 pyproject.toml 中聲明的所有生產環境和開發環境依賴項，如果需要的話創建虛擬環境，並鎖定每個貢獻者或CI管道使用的相同版本。

💻 使用示例

基礎用法

編輯你的 claude_desktop_config.json 文件以添加Swemo 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. 以開發者模式運行

uv run

3. 進行代碼變更後重新構建和啟動服務

uv sync && uv run

📄 許可證

文檔中未提及相關許可證信息。

⚠️ 重要提示

• 文檔中的所有代碼示例均在Ubuntu 22.04 LTS上測試。
• 確保安裝了最新版本的Python和依賴管理工具。

這個項目允許開發者方便地訪問瑞典央行的貨幣政策數據，支持多種集成方式，並提供了詳細的文檔說明。無論是通過Docker容器運行還是直接使用庫，開發者都能以靈活的方式接入這些重要數據源。