🌤️ Weather Microservice with MCP + UV

🌤️ MCP + UV を使った天気マイクロサービス

Python の依存関係管理に uv、コンテナ化したデプロイに Docker を使用する、軽量な MCP 対応の天気 API サービスです。シームレスなローカル開発、Claude Desktop との連携、スケーラブルなデプロイを実現します。

---

🚀 特長

• 🧪 uv と mcp を使ったライブリロード対応の高速なローカル開発
• 🐳 本番環境やステージング環境向けにDocker 化
• 🧠 Claude Desktop との連携に対応
• 🔐 .env または環境変数からシークレットを安全に読み込みます

---

⚙️ サーバーの実行

🧪 開発モード（MCP Inspector を使用）

ホットリロードを有効にして、開発モードでサーバーを起動します。

uv run mcp dev server.py

依存関係を実行時に追加します。

uv run mcp dev server.py --with pandas --with numpy

ローカルコードを編集可能な状態でマウントします。

uv run mcp dev server.py --with-editable .

---

🧠 Claude Desktop との連携

サーバーを Claude Desktop にインストールします。

uv run mcp install server.py

カスタム名を指定します。

uv run mcp install server.py --name "My Analytics Server"

環境変数を渡します。

uv run mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
uv run mcp install server.py -f .env

---

🔧 直接実行

より細かく制御する場合や、高度なデプロイを行う場合に使用します。

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("My App")

if __name__ == "__main__":
    mcp.run()

手動で実行します。

uv run python server.py
# or
uv run mcp run server.py

---

🐳 Docker のサポート

🔨 イメージのビルド

docker build -t weather-service .

▶️ コンテナの実行

docker run --env-file .env -p 6274:6274 weather-service

---

📁 プロジェクト構成

.
├── server.py
├── .env
├── pyproject.toml
├── uv.lock
├── Dockerfile
└── README.md

---

🔒 環境変数

.env ファイルを作成します。

API_KEY=your_api_key_here
DB_URL=your_database_url_here

---

📦 依存関係の管理

uv を使って依存関係を管理し、同期します。

uv pip install mcp
uv pip install pandas numpy
uv sync  # sync dependencies based on uv.lock

---

📃 ライセンス

MIT License ― 自由に使用でき、責任を持って変更できます。