MCP Second Project Weather Forecaster

🚀 Weather MCP Server

FastMCPを用いて構築された強力な天気情報サーバーです。複数のインターフェースを通じて、天気警報とツールを提供します。

🚀 クイックスタート

オプション1: 対話型ランチャー（推奨）

python run_server.py

これにより、MCPサーバーまたはWebインターフェースを実行するオプションが表示されます。

オプション2: 直接Webインターフェースを起動

python server/web_interface.py

その後、ブラウザで以下のURLを開きます: http://localhost:8000

オプション3: MCPサーバーのみを起動

python main.py

✨ 主な機能

• 🌤️ 天気警報: 米国の任意の州のリアルタイム天気警報を取得できます。
• 🔊 エコーリソース: 単純なメッセージエコー機能を備えています。
• 🖥️ 複数のインターフェース: MCPサーバーまたはWebインターフェースから選択できます。
• 🎨 美しいUI: モダンでレスポンシブなWebインターフェースを持っています。

📦 インストール

1. 依存関係をインストールする:

   uv sync
   

2. サーバーを起動する:

   python run_server.py
   

💻 使用例

基本的な使用法

Webインターフェース

1. Webインターフェースを起動します。
2. ブラウザで http://localhost:8000 を開きます。
3. フォームを使用して以下のことができます:
   • 米国の州（例: CA, NY, TX）の天気警報を取得する。
   • リソースシステムを通じてメッセージをエコーする。

MCPサーバー

MCPサーバーは以下のツールを提供します:

• get_alerts(state): 米国の州の天気警報を取得します。
  • state: 米国の州の2文字コード（例: "CA", "NY"）
• echo_resource(message): メッセージをリソースとしてエコーします。
  • message: エコーする任意のテキストメッセージ

高度な使用法

MCPサーバーを使用して、コード内から直接天気警報やエコー機能を利用することができます。

# 以下はサンプルコードで、実際の環境に合わせて調整が必要です。
# ここではMCPサーバーに接続して、天気警報を取得する例を示します。
# まず、必要なライブラリをインポートします。
import mcp

# MCPサーバーに接続します。
server = mcp.connect('localhost', 8000)

# 米国のある州（例えばカリフォルニア州）の天気警報を取得します。
alerts = server.get_alerts('CA')

# 取得した警報を表示します。
print(alerts)

📚 ドキュメント

APIエンドポイント

• GET /: メインのWebインターフェース
• POST /api/alerts: 天気警報を取得します（フォームデータ: state）
• POST /api/echo: メッセージをエコーします（フォームデータ: message）

依存関係

• mcp[cli]>=1.13.0: MCPサーバーフレームワーク
• fastapi>=0.104.0: Webフレームワーク
• uvicorn[standard]>=0.24.0: ASGIサーバー
• httpx>=0.25.0: HTTPクライアント
• python-multipart>=0.0.6: フォームデータの処理

プロジェクト構造

secondproject/
├── main.py                 # MCPサーバーのエントリーポイント
├── run_server.py          # 対話型ランチャー
├── server/
│   ├── weather.py         # MCPサーバーの実装
│   └── web_interface.py   # Webインターフェース
├── pyproject.toml         # プロジェクトの設定
└── README.md              # このファイル

トラブルシューティング

一般的な問題

1. ポートが既に使用されている: web_interface.py でポートを変更するか、他のサービスを停止します。
2. 依存関係が不足している: uv sync を実行してすべての依存関係をインストールします。
3. APIエラー: 天気データを取得するためのインターネット接続を確認します。

ヘルプの取得

• コンソール出力のエラーメッセージを確認します。
• すべての依存関係がインストールされていることを確認します。
• Pythonのバージョンが3.12以上であることを確認します。

📄 ライセンス

このプロジェクトはオープンソースで、MITライセンスの下で利用可能です。