🚀 一个瑞典的货币政策数据服务器：Kolada MCP
本项目是一个非官方的 MCP（货币政策协议）服务器，旨在提供对瑞典央行（Sveriges Riksbank）数据的访问途径。用户可借助现代 API 和工具链，对瑞典央行的货币政策数据进行查询与分析。
🚀 快速开始
该项目是一个非官方的 MCP 服务器，允许用户通过现代 API 和工具链查询和分析瑞典央行的货币政策数据。你可以按照以下步骤开始使用：
- 完成安装指南中的先决条件和安装步骤。
- 参考“作为库使用”部分的代码示例，将工具集成到你的项目中。
- 若需与 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 文件展示了如何挂载源目录并实现热重新加载。
📚 详细文档
开发指南
- 设置环境
uv sync --dev
- 以开发模式运行服务器，并启用实时重载（需要安装
mcp dev）：
uv run mcp dev src/swemo_mcp/server.py
- 打开 MCP 监视器 以测试和调试： http://localhost:5173
- 运行测试套件（使用 pytest 和 asyncio）：
uv run pytest -q
- 格式化与检查代码 自动使用 Ruff：
uv run ruff check . --fix
📄 许可证
项目在 Apache 2.0 许可证下发布。完整的许可文本可在 文件中找到。
⚠️ 免责声明
- 这是一个 非官方 的 MCP 服务器，用于访问 Sveriges Riksbank 的数据。底层 API 可能会更改，该项目可能无法始终反映最新的更新。
- Sveriges Riksbank 对此项目的开发没有任何参与。提供的数据“按现状”提供，不附带任何形式的保证。
- 所有错误和不准确之处均为作者的责任，并欢迎任何反馈或修正。