noaa-tidesandcurrents-mcp

Instructions

Implementation Reference

• src/services/noaa-service.ts:94-99 (handler)

  Core handler function that fetches currents data from the NOAA API by setting product='currents' and calling the internal fetchDataApi method.

  async getCurrents(params: Record<string, any>): Promise<any> {
    return this.fetchDataApi({
      ...params,
      product: 'currents'
    });
  }

• src/server/mcp-server.ts:54-61 (registration)

  Registers the 'get_currents' tool in the MCP server by defining an MCPTool object that delegates to noaaService.getCurrents.

  const getCurrents: MCPTool = {
    name: "get_currents",
    description: "Get currents data for a station",
    inputSchema: GetCurrentsSchema,
    handler: async (params) => {
      return this.noaaService.getCurrents(params);
    }
  };

• src/interfaces/noaa.ts:50-63 (schema)

  Defines the Zod input schema (GetCurrentsSchema) for validating parameters to the get_currents tool.

  export const GetCurrentsSchema = z.object({
    station: StationSchema,
    date: DateSchema,
    begin_date: BeginDateSchema,
    end_date: EndDateSchema,
    range: RangeSchema,
    bin: BinSchema,
    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/tools/water-tools.ts:82-107 (registration)

  Alternative registration of the 'get_currents' tool using FastMCP, with inline Zod schema and execution handler calling noaaService.getCurrents.

  server.addTool({
    name: 'get_currents',
    description: 'Get currents data for a station',
    parameters: z.object({
      station: StationSchema,
      date: DateSchema,
      begin_date: BeginDateSchema,
      end_date: EndDateSchema,
      range: RangeSchema,
      bin: BinSchema,
      units: UnitsSchema,
      time_zone: TimeZoneSchema,
      format: FormatSchema,
    }).refine(refineDateParams, { message: dateRefinementMessage }),
    execute: async (params) => {
      try {
        const result = await noaaService.getCurrents(params);
        return JSON.stringify(result);
      } catch (error) {
        if (error instanceof Error) {
          throw new Error(`Failed to get currents: ${error.message}`);
        }
        throw new Error('Failed to get currents');
      }
    }
  });