get-weather-forecast

Retrieve weather forecasts by providing city names to access current conditions and predictions through structured API calls.

Instructions

根据经纬度获取天气信息

Input Schema

TableJSON Schema

Name	Required	Description	Default
`city`	No

Implementation Reference

src/index.ts:57-73 (handler)

The handler function that implements the core logic of the 'get-weather-forecast' tool. It constructs the API URL using the gaode endpoint and key, fetches the weather data for the given city, types it as Root, and returns a standardized content response with the JSON stringified data.

async ({ city }) => {
  // 获取网格点数据的 URL
  const pointsUrl = `${gaode}?key=${key}&city=${city}`;

  const data: Root = await fetch(pointsUrl).then((response) =>
    response.json(),
  );

  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify(data),
      },
    ],
  };
},

src/index.ts:16-36 (schema)

TypeScript interfaces defining the expected structure of the weather API response data, used for typing the 'data' variable in the handler.

export interface Root {
  status: string;
  count: string;
  info: string;
  infocode: string;
  lives: Lfe[];
}

export interface Lfe {
  province: string;
  city: string;
  adcode: string;
  weather: string;
  temperature: string;
  winddirection: string;
  windpower: string;
  humidity: string;
  reporttime: string;
  temperature_float: string;
  humidity_float: string;
}

src/index.ts:53-56 (schema)
Zod validation schema for the tool's input parameters. Defines an optional 'city' string parameter.
```
{
  city: z.string().optional(),
},
// 工具的异步处理函数
```

src/index.ts:46-74 (registration)

The MCP server.tool registration for the 'get-weather-forecast' tool, including name, description, input schema, and inline handler implementation.

// 注册获取天气预报的工具
server.tool(
  // 工具名称
  'get-weather-forecast',
  // 工具描述
  '根据经纬度获取天气信息',
  // 工具参数
  {
    city: z.string().optional(),
  },
  // 工具的异步处理函数
  async ({ city }) => {
    // 获取网格点数据的 URL
    const pointsUrl = `${gaode}?key=${key}&city=${city}`;

    const data: Root = await fetch(pointsUrl).then((response) =>
      response.json(),
    );

    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(data),
        },
      ],
    };
  },
);

src/index.ts:13-14 (helper)
Constants defining the Amap (Gaode) weather API endpoint URL and the API key loaded from environment variables, used in the tool handler.
```
const gaode = 'https://restapi.amap.com/v3/weather/weatherInfo';
const key = process.env.GAODE_KEY;
```

MCP-Server