noaa-tidesandcurrents-mcp

Instructions

Implementation Reference

• src/services/noaa-service.ts:114-120 (handler)

  Core handler function that fetches meteorological data from NOAA API by calling fetchDataApi with the provided parameters including the product type.

  async getMeteorologicalData(params: Record<string, any>): Promise<any> {
    const { product, ...rest } = params;
    return this.fetchDataApi({
      ...rest,
      product
    });
  }

• src/interfaces/noaa.ts:84-97 (schema)

  Zod schema defining input parameters for the get_meteorological_data tool, including station, product, date parameters, with validation refinement.

  export const GetMeteorologicalDataSchema = z.object({
    station: StationSchema,
    product: z.string().min(1).describe('Product (air_temperature, wind, etc.)'),
    date: DateSchema,
    begin_date: BeginDateSchema,
    end_date: EndDateSchema,
    range: RangeSchema,
    units: UnitsSchema,
    time_zone: TimeZoneSchema,
    format: FormatSchema,
  }).refine(
    data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range),
    { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" }
  );

• src/server/mcp-server.ts:74-81 (registration)

  Tool registration in McpServer class: defines the MCPTool object with name, description, schema, and handler delegating to NoaaService.

  const getMeteorologicalData: MCPTool = {
    name: "get_meteorological_data",
    description: "Get meteorological data",
    inputSchema: GetMeteorologicalDataSchema,
    handler: async (params) => {
      return this.noaaService.getMeteorologicalData(params);
    }
  };

• src/tools/water-tools.ts:140-165 (registration)

  Alternative tool registration using FastMCP server.addTool, with inline Zod parameters schema and execute handler calling NoaaService.

  server.addTool({
    name: 'get_meteorological_data',
    description: 'Get meteorological data',
    parameters: z.object({
      station: StationSchema,
      product: z.string().min(1).describe('Product (air_temperature, wind, etc.)'),
      date: DateSchema,
      begin_date: BeginDateSchema,
      end_date: EndDateSchema,
      range: RangeSchema,
      units: UnitsSchema,
      time_zone: TimeZoneSchema,
      format: FormatSchema,
    }).refine(refineDateParams, { message: dateRefinementMessage }),
    execute: async (params) => {
      try {
        const result = await noaaService.getMeteorologicalData(params);
        return JSON.stringify(result);
      } catch (error) {
        if (error instanceof Error) {
          throw new Error(`Failed to get meteorological data: ${error.message}`);
        }
        throw new Error('Failed to get meteorological data');
      }
    }
  });