瑞典国家银行 MCP 服务器

一个用于从瑞典国家银行访问宏观经济和金融数据的 MCP 服务器。该服务器提供用于检索以下数据的工具：货币政策预测、汇率和利率数据（通过 SWEA）以及短期货币市场利率（通过 SWESTR）。它使用带有 httpx 的异步编程构建，并使用 pydantic 进行数据验证。

特性

• 货币政策工具

  • 列出所有货币政策轮次。
  • 检索关键经济指标的预测数据（GDP、失业率、CPI、CPIF、CPIF（不含能源）、小时劳动力成本、工资（NA 和 NMO）、人口、就业、劳动力）。

• SWEA 工具

  • 获取官方政策（回购）利率。
  • 检索汇率序列（USD/SEK、EUR/SEK、GBP/SEK）。
  • 检索平均抵押贷款利率。

• SWESTR 工具

  • 检索每日 SWESTR（瑞典短期利率）及其最新发布值。
  • 检索复合平均值（例如，1 周、1 个月）。

• 现代、异步和类型安全

  • 完全异步，使用 Python 3.13 的 async/await 和 httpx 进行网络请求。
  • 使用 pydantic 模型进行强大的数据验证和自文档化的 API 响应。

安装

确保您已安装 Python 3.13 或更高版本。 然后，以可编辑模式安装软件包：

pip install -e .

这将安装 pyproject.toml 中指定的必需依赖项（包括 mcp、httpx 和 pydantic）。

运行服务器

使用 CLI

安装后，您可以使用 CLI 命令启动 MCP 服务器：

riksbanken-mcp

通过 Python 模块

或者，直接使用以下命令运行服务器：

python -m riksbank_mcp.server

服务器使用 stdio 传输进行通信并注册所有 MCP 工具。

仓库结构

riksbank_mcp/
├── __init__.py             # 包版本和初始化
├── server.py               # 主要 MCP 服务器入口点和工具注册
├── models.py               # 用于 API 响应和数据验证的 Pydantic 模型
├── services/
│   ├── __init__.py         # 服务包初始化
│   ├── monetary_policy_api.py  # 货币政策 API 的助手
│   ├── swea_api.py         # SWEA API 的助手
│   └── swestr_api.py       # SWESTR API 的助手
├── tools/
│   ├── __init__.py         # 工具包初始化
│   ├── monetary_policy_tools.py  # 用于货币政策数据的工具
│   ├── swea_tools.py       # 用于 SWEA 数据的工具（政策利率、汇率、抵押贷款利率）
│   └── swestr_tools.py     # 用于 SWESTR 数据的工具（短期利率和平均值）
└── pyproject.toml          # 构建和依赖项配置

使用示例

示例：获取 GDP 预测数据

import asyncio
from riksbank_mcp.tools.monetary_policy_tools import get_gdp_data

async def main():
    # 检索特定政策轮次的 GDP 预测数据。
    gdp_forecast = await get_gdp_data("2023:4")
    for obs in gdp_forecast.observations:
        print(f"Date: {obs.date}, GDP forecast: {obs.value} (billion SEK)")

asyncio.run(main())

示例：检索最新的 SWESTR 利率

import asyncio
from riksbank_mcp.tools.swestr_tools import get_latest_swestr

async def main():
    latest = await get_latest_swestr()
    print(f"Latest SWESTR: {latest.date} - {latest.value}%")

asyncio.run(main())

示例：检索 USD/SEK 汇率

import asyncio
from riksbank_mcp.tools.swea_tools import get_usd_exchange_rate

async def main():
    usd_data = await get_usd_exchange_rate()
    for obs in usd_data.observations[-5:]:
        print(f"{obs.date}: {obs.value} SEK per USD")

asyncio.run(main())

测试

我们使用 pytest 以及 pytest-asyncio 进行测试。 使用以下命令运行测试套件：

pytest

贡献

欢迎贡献！ 提交更改时，请遵守以下原则：

• 遵循 PEP 8 和 Python 3.13 的类型提示约定。
• 始终如一地使用异步编程。
• 相应地更新文档字符串和 Pydantic 模型。
• 确保新的工具或更改已通过测试覆盖。

许可证

该项目已获得 MIT 许可证的许可。 有关详细信息，请参见 LICENSE。

附加资源

• 瑞典国家银行 API 文档
• MCP 文档
• Pydantic 文档
• httpx 文档