get-weather-forecast
Retrieve weather forecasts by providing city names to access current conditions and predictions through structured API calls.
Instructions
根据经纬度获取天气信息
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get-weather-forecast"
}
}Input 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;