Swemo MCP

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

このサーバーは、スウェーデン中央銀行（Riksbank）のデータ用に作成されたModel Context Protocol (MCP) サーバーです。一貫性があり強力なインターフェースを通じて、スウェーデン中央銀行の通貨政策データにアクセスできるようになります。

🚀 クイックスタート

このMCPサーバーを使うことで、スウェーデン中央銀行の通貨政策データに簡単にアクセスできます。以下のセクションでは、インストール方法や使用例、開発に関する情報を提供します。

✨ 主な機能

• 約30種類の異なる通貨政策関連のデータ系列を提供します。
• 特定の時系列バージョン（政策サイクル）を指定するか、完全な履歴データを取得できます。
• Pythonコードで直接使用することも、Dockerコンテナで実行することも可能で、簡単に統合できます。

📦 インストール

⚠️ 重要提示

• Python ≥ 3.12 ( typing.TypeAlias/PEP 604 ユニオンを使用)
• Astral uv ≥ 0.2.0

プロジェクトのクローンとセットアップは1つのコマンドで行えます:

uv sync

uv sync は、pyproject.toml で宣言されたすべての本番環境と開発環境の依存関係をインストールし、必要に応じて仮想環境を作成し、各貢献者やCIパイプラインで使用する同じバージョンをロックします。

📚 ドキュメント

Claude Desktopとの統合

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コンテナで実行するか、ライブラリを直接使用するかに関わらず、開発者は柔軟な方法でこれらの重要なデータソースにアクセスできます。