中国城市天气查询 MCP 服务

中国の都市の天気を検索する MCP サービス

高徳地図 API に基づく、中国の都市の天気を検索する Model Context Protocol (MCP) サービスです。このサービスを使うと、簡単なリクエストで中国各地のリアルタイムの天気状況や数日先までの天気予報を取得できます。

機能

• 高徳地図の天気 API を使用して、中国の都市の正確な天気データを取得します
• リアルタイムの天気状況を検索できます
• 今後 3～4 日間の天気予報を検索できます
• 都市や区・県レベルの検索を含む、都市名のスマート認識に対応しています
• 都市名の検索機能に対応しています
• 標準的な MCP サービスとして実装されており、AI アプリケーションに簡単に統合できます

インストール方法

前提条件

• 高徳地図開発者向け API キー（環境変数で設定する必要があります）

インストール手順

1. このリポジトリをクローンまたはダウンロードします
2. プロジェクトディレクトリに移動します
3. uv を使用して依存関係をインストールします：

uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx

使用方法

MCP サービスの起動

この MCP サービスをテストするクライアントを自分で作成する場合は、手動で起動してください。 ターミナルで次のコマンドを実行して MCP サービスを起動します：

uv run weather.py

統合済み MCP サービスの使用

Claude Desktop での使用

Claude Desktop で使用する場合は、サーバー設定を追加してください： テキストエディターで Claude for Desktop App の設定ファイルを開きます。パスの例は ~/Library/Application Support/Claude/claude_desktop_config.json です。 ファイルが存在しない場合は、必ず作成してください。

{
    "mcpServers": {
        "amap-weather-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "weather.py"
            ],
            "env": {
                "AMAP_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

Cherry Studio での使用

次の画像のように設定してください：

サービスの呼び出し

MCP サービスには、天気を検索するための主なツール関数が 3 つあります：

1. get_current_weather：都市の現在の天気状況を取得します
2. get_weather_forecast：今後数日間の天気予報を取得します
3. search_city：都市名を検索します

MCP クライアントから呼び出す例：

from mcp.client import Client

# 连接到服务
client = Client("amap-weather-mcp-server")

# 查询实时天气
current_weather = await client.get_current_weather("北京市")
print(current_weather)

# 查询天气预报
forecast = await client.get_weather_forecast("上海市")
print(forecast)

# 搜索城市名称
cities = await client.search_city("广州")
print(cities)

API リファレンス

get_current_weather

指定した都市のリアルタイムの天気データを取得します。

パラメーター：

• city：中国の都市名。北京市、上海市、海珠区など、省・市・県などの行政区画を含める必要があります

戻り値： 都市のリアルタイムの天気情報を整形した文字列。次の内容が含まれます：

• 都市名
• 天気状況
• 気温
• 風向
• 風力
• 湿度
• 発表時刻

get_weather_forecast

指定した都市の天気予報（今後 3～4 日間）を取得します。

パラメーター：

• city：中国の都市名。北京市、上海市、浙江省杭州市など、省・市・県などの行政区画を含める必要があります

戻り値： 都市の天気予報情報を整形した文字列。次の内容が含まれます：

• 都市名
• 今後数日間の日付
• 昼間と夜間の天気状況
• 昼間と夜間の気温
• 昼間と夜間の風向・風力

search_city

キーワードに一致する都市名を検索します。

パラメーター：

• keyword：都市名のキーワード。広州市、海珠区など、省・市・県などの行政区画を含めることをおすすめします

戻り値： 一致した都市名の一覧を含む文字列です。

データソース

本サービスは、高徳地図オープンプラットフォームが提供する天気データ API を使用します：

• リアルタイム天気データ API：https://restapi.amap.com/v3/weather/weatherInfo
• 都市コードデータ：AMap_adcode_citycode.csv

注意事項

• 本サービスは中国本土の都市の天気検索にのみ対応しています
• 高徳地図 API にはリクエスト頻度の制限がある場合があります
• 都市名の認識では、都市名または区・県名を直接入力できます（「市」「県」「区」などの行政区画を付けることをおすすめします）
• 環境変数を正しく設定しないと、API リクエストは失敗します

ライセンス

MIT ライセンス