Amap Weather MCP Server

🚀 中国城市天気検索 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 = client.get_current_weather()
print(current_weather)

# 今後の天気予報を検索
forecast = client.get_weather_forecast()
print(forecast)

# 都市を検索
cities = client.search_city("上海")
print(cities)

📚 注意事項

⚠️ 重要提示

環境変数を正しく設定しないと、API リクエストが失敗します。

💡 使用建议

都市名の認識では、都市名または区県名を直接入力することができます（「市」「県」「区」などの行政区画識別子を付けることをおすすめします）。また、高德地図 API の使用には、そのサービス条項と制限に従う必要があります。

📄 ライセンス

MIT ライセンス