AMap MCP Server

Instructions

Args:
    city (str): The city to query the weather.

Implementation Reference

• amap_mcp/server.py:37-47 (handler)

  MCP tool handler for 'query_weather'. Registered via @mcp.tool decorator, includes input schema description in Args, executes by delegating to AmapClient.async_query_weather.

  @mcp.tool(
      description="""The weather service of Amap. Query the weather of a given city.
      
      Args:
          city (str): The city to query the weather.
      """
  )
  async def query_weather(city: str):
      logger.info(f"query_weather is called.")
      return await async_client.async_query_weather(city)

• amap_mcp/amap/query_weather/client.py:23-36 (helper)

  Core asynchronous helper function in AmapQueryWeatherClient that performs the actual HTTP GET request to the Amap weather API endpoint.

  async def async_query_weather_impl(self, city: str):
      url = "https://restapi.amap.com/v3/weather/weatherInfo"
      request_data = {
          "city": city,
          "key": self.key
      }
      logger.info(f"request_data: {request_data}")
      try:
          response = await self.httpx_client.get(url, params=request_data)
          return response.json()
      except Exception as e:
          logger.error(f"error: {e}")
          raise e

• amap_mcp/amap/client.py:8-20 (helper)

  AmapClient wrapper class that initializes and delegates to AmapQueryWeatherClient for query_weather functionality.

  from .query_weather.client import AmapQueryWeatherClient
  
  class AmapClient:
      def __init__(self, key: str, httpx_client: typing.Union[httpx.Client, httpx.AsyncClient]):
          self.key = key
          self.httpx_client = httpx_client
          self.query_weather_client = AmapQueryWeatherClient(key, httpx_client)
  
      def query_weather(self, city: str):
          return self.query_weather_client.query_weather_impl(city)
      
      async def async_query_weather(self, city: str):
          return await self.query_weather_client.async_query_weather_impl(city)