Riksbank MCP

🚀 スウェーデンの通貨政策データサーバー：Kolada MCP

このプロジェクトは、Sveriges Riksbankのデータへのアクセスを提供する非公式のMCP（通貨政策プロトコル）サーバーです。ユーザーは、このサーバーを通じて、最新のAPIとツールチェーンを使用して、スウェーデン中央銀行の通貨政策データを照会および分析することができます。

✨ 主な機能

• 最新の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 ライセンスの下で公開されています。完全なライセンステキストは ファイルに記載されています。

免責事項

• これは Sveriges Riksbank のデータにアクセスするための非公式の MCP サーバーです。基盤となる API は変更される可能性があり、このプロジェクトが最新の更新を常に反映するとは限りません。
• Sveriges Riksbank はこのプロジェクトの開発に一切関与していません。提供されるデータは「現状のまま」提供され、いかなる保証も付属していません。
• すべてのエラーや不正確さは著者の責任であり、フィードバックや修正は大歓迎です。