Amap Weather MCP Server

🚀 China City Weather Query MCP Service

This is a Model Context Protocol (MCP) service for querying the weather of Chinese cities based on the Gaode Map API. It allows users to obtain real - time weather conditions and forecasts for the next few days of various Chinese cities through simple requests.

🚀 Quick Start

This service provides easy - to - use interfaces for querying the weather of Chinese cities. You can quickly integrate it into your AI applications or test it in different environments.

✨ Features

• Use the Gaode Map weather API to obtain accurate weather data for Chinese cities.
• Support querying real - time weather conditions.
• Support querying weather forecasts for the next 3 - 4 days.
• Support intelligent city name recognition, including queries at the city and district - county levels.
• Support the city name search function.
• Implemented as a standard MCP service, making it easy to integrate into AI applications.

📦 Installation

Prerequisites

• Gaode Map developer API key (needs to be configured through environment variables)

Installation Steps

1. Clone or download this repository.
2. Navigate to the project directory.
3. Use uv to install dependencies:

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

💻 Usage Examples

Starting the MCP Service

If you need to create a client to test this MCP service, you need to start it manually. Execute the following command in the terminal to start the MCP service:

uv run weather.py

Using the Integrated MCP Service

Using in Claude Desktop

If you want to use it in Claude Desktop, add the server configuration: Open the Claude for Desktop App configuration in a text editor. The path is similar to ~/Library/Application Support/Claude/claude_desktop_config.json. If the file does not exist, make sure to create it.

{
    "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"
            }
        }
    }
}

Using in Cherry Studio

Configure it as shown in the following image:

Calling the Service

The MCP service provides three main utility functions for weather queries:

1. get_current_weather: Get the current weather conditions of a city.
2. get_weather_forecast: Get the weather forecast for the next few days.
3. search_city: Search for a city name.

Example of calling using an MCP client:

from mcp.client import Client

# Connect to the service
client = Client("amap-weather-mcp-server")

# Query the real - time weather
current_weather = client.get_current_weather()
print(current_weather)

# Query the future weather forecast
forecast = client.get_weather_forecast()
print(forecast)

# Search for a city
cities = client.search_city("Shanghai")
print(cities)

📚 Documentation

Important Notes

⚠️ Important Note

The environment variables must be configured correctly; otherwise, the API requests will fail.

⚠️ Important Note

City name recognition supports directly entering the city name or district - county name (it is recommended to include administrative division identifiers such as "City", "County", "District", etc.).

⚠️ Important Note

The use of the Gaode Map API must comply with its terms of service and restrictions.

📄 License

MIT License