MCP Weather Server

FastMCPベースの天気検索MCPサーバーで、現在の天気、今後の天気予報、摂氏/華氏の変換、人気都市のリソース、および旅行の天気アドバイス用プロンプトを提供します。

プロジェクトには2つの起動エントリーポイントが含まれています：

• server.py：ローカルstdioモード。Claude Desktop、Cursor、Cherry StudioなどのローカルMCPクライアントに適しています。

• server_remote.py：Streamable HTTPモード。ModelScopeなどのリモートホスティングプラットフォームへのデプロイに適しています。

機能

• get_weather(city: str)：指定した都市の現在の天気を検索します。

• get_forecast(city: str, days: int = 3)：指定した都市の今後の天気予報を検索します（デフォルトは3日間）。

• temperature_convert(value: float, from_unit: str)：摂氏と華氏の相互変換を行います。

• weather://cities：よく使われる都市リストのリソースを返します。

• travel_advisor(destination: str, date: str)：旅行の天気アドバイス用プロンプトを生成します。

天気データは wttr.in から取得しており、追加のAPIトークンは不要です。

環境要件

• Python >= 3.12

• 依存関係の管理には uv を推奨します

依存関係のインストール

uv sync

uv を使用しない場合は、仮想環境で依存関係をインストールすることも可能です：

pip install "mcp[cli]>=1.27.0" "httpx>=0.28.1"

ローカル実行

stdioモード：

uv run python server.py

MCPクライアントの設定例：

{
  "mcpServers": {
    "weather-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"]
    }
  }
}

リモート実行

Streamable HTTPモード：

uv run python server_remote.py

デフォルトのリスニング：

http://0.0.0.0:8000/mcp/

リモートMCPクライアントの設定例：

{
  "mcpServers": {
    "weather-server": {
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

ModelScopeへのデプロイ手順

ModelScopeでMCP Serverを作成またはデプロイする際は、本プロジェクトのGitHubリポジトリURLを入力し、リモート用のエントリーファイルを使用してください：

python server_remote.py

サービスはStreamable HTTP方式で起動し、0.0.0.0:8000 をリッスンします。MCPエンドポイントは以下の通りです：

/mcp/

プラットフォームがカスタム起動コマンドをサポートしている場合は、以下を推奨します：

uv run python server_remote.py

または、プラットフォーム環境で事前に依存関係をインストールした後に以下を使用します：

python server_remote.py

プロジェクト構造

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

ライセンス

オープンソースとして公開する場合は、実際の状況に合わせてLicenseファイルを追加してください。