Weather MCP

Instructions

Implementation Reference

• src/index.ts:82-156 (handler)

  The handler function that implements the core logic of the 'get-forecast' tool. It takes latitude and longitude, queries the NWS API for grid points and forecast data, formats the periods, and returns a text response.

  async ({ latitude, longitude }) => {
      // Get grid point data
      const pointsUrl = `${NWS_API_BASE}/points/${latitude.toFixed(4)},${longitude.toFixed(4)}`;
      const pointsData = await makeNWSRequest<PointsResponse>(pointsUrl);
  
      if (!pointsData) {
          return {
              content: [
                  {
                      type: "text",
                      text: `Failed to retrieve grid point data for coordinates: ${latitude}, ${longitude}. This location may not be supported by the NWS API (only US locations are supported).`,
                  },
              ],
          };
      }
  
      const forecastUrl = pointsData.properties?.forecast;
      if (!forecastUrl) {
          return {
              content: [
                  {
                      type: "text",
                      text: "Failed to get forecast URL from grid point data",
                  },
              ],
          };
      }
  
      // Get forecast data
      const forecastData = await makeNWSRequest<ForecastResponse>(forecastUrl);
      if (!forecastData) {
          return {
              content: [
                  {
                      type: "text",
                      text: "Failed to retrieve forecast data",
                  },
              ],
          };
      }
  
      const periods = forecastData.properties?.periods || [];
      if (periods.length === 0) {
          return {
              content: [
                  {
                      type: "text",
                      text: "No forecast periods available",
                  },
              ],
          };
      }
  
      // Format forecast periods
      const formattedForecast = periods.map((period: ForecastPeriod) =>
          [
              `${period.name || "Unknown"}:`,
              `Temperature: ${period.temperature || "Unknown"}°${period.temperatureUnit || "F"}`,
              `Wind: ${period.windSpeed || "Unknown"} ${period.windDirection || ""}`,
              `${period.shortForecast || "No forecast available"}`,
              "---",
          ].join("\n"),
      );
  
      const forecastText = `Forecast for ${latitude}, ${longitude}:\n\n${formattedForecast.join("\n")}`;
  
      return {
          content: [
              {
                  type: "text",
                  text: forecastText,
              },
          ],
      };
  },

• src/index.ts:78-81 (schema)

  Zod input schema defining parameters for latitude and longitude in the get-forecast tool.

  {
      latitude: z.number().min(-90).max(90).describe("Latitude of the location"),
      longitude: z.number().min(-180).max(180).describe("Longitude of the location"),
  },

• src/index.ts:75-157 (registration)

  Registration of the 'get-forecast' tool on the MCP server, including name, description, schema, and handler.

  server.tool(
      "get-forecast",
      "Get weather forecast for a location",
      {
          latitude: z.number().min(-90).max(90).describe("Latitude of the location"),
          longitude: z.number().min(-180).max(180).describe("Longitude of the location"),
      },
      async ({ latitude, longitude }) => {
          // Get grid point data
          const pointsUrl = `${NWS_API_BASE}/points/${latitude.toFixed(4)},${longitude.toFixed(4)}`;
          const pointsData = await makeNWSRequest<PointsResponse>(pointsUrl);
  
          if (!pointsData) {
              return {
                  content: [
                      {
                          type: "text",
                          text: `Failed to retrieve grid point data for coordinates: ${latitude}, ${longitude}. This location may not be supported by the NWS API (only US locations are supported).`,
                      },
                  ],
              };
          }
  
          const forecastUrl = pointsData.properties?.forecast;
          if (!forecastUrl) {
              return {
                  content: [
                      {
                          type: "text",
                          text: "Failed to get forecast URL from grid point data",
                      },
                  ],
              };
          }
  
          // Get forecast data
          const forecastData = await makeNWSRequest<ForecastResponse>(forecastUrl);
          if (!forecastData) {
              return {
                  content: [
                      {
                          type: "text",
                          text: "Failed to retrieve forecast data",
                      },
                  ],
              };
          }
  
          const periods = forecastData.properties?.periods || [];
          if (periods.length === 0) {
              return {
                  content: [
                      {
                          type: "text",
                          text: "No forecast periods available",
                      },
                  ],
              };
          }
  
          // Format forecast periods
          const formattedForecast = periods.map((period: ForecastPeriod) =>
              [
                  `${period.name || "Unknown"}:`,
                  `Temperature: ${period.temperature || "Unknown"}°${period.temperatureUnit || "F"}`,
                  `Wind: ${period.windSpeed || "Unknown"} ${period.windDirection || ""}`,
                  `${period.shortForecast || "No forecast available"}`,
                  "---",
              ].join("\n"),
          );
  
          const forecastText = `Forecast for ${latitude}, ${longitude}:\n\n${formattedForecast.join("\n")}`;
  
          return {
              content: [
                  {
                      type: "text",
                      text: forecastText,
                  },
              ],
          };
      },
  );

• src/helper.ts:2-19 (helper)

  Helper function makeNWSRequest used by the get-forecast handler to perform API requests to the National Weather Service.

  export async function makeNWSRequest<T>(url: string): Promise<T | null> {
      const USER_AGENT = "weather-app/1.0";
      const headers = {
          "User-Agent": USER_AGENT,
          Accept: "application/geo+json",
      };
  
      try {
          const response = await fetch(url, { headers });
          if (!response.ok) {
              throw new Error(`HTTP error! status: ${response.status}`);
          }
          return (await response.json()) as T;
      } catch (error) {
          console.error("Error making NWS request:", error);
          return null;
      }
  }

• src/helper.ts:57-67 (schema)

  TypeScript interfaces for PointsResponse and ForecastResponse used in type assertions for NWS API responses in get-forecast.

  export interface PointsResponse {
      properties: {
          forecast?: string;
      };
  }
  
  export interface ForecastResponse {
      properties: {
          periods: ForecastPeriod[];
      };
  }