LocalTides MCP Server

Instructions

Implementation Reference

• src/services/noaa-service.ts:165-170 (handler)

  Implements the core logic to fetch detailed station information from NOAA's metadata API by constructing the endpoint `/stations/{station}/details.{format}` and calling fetchMetadataApi.

  async getStationDetails(params: Record<string, any>): Promise<any> {
    const { station, ...rest } = params;
    const endpoint = `/stations/${station}/details.` + (rest.format || 'json');
    
    return this.fetchMetadataApi(endpoint, rest);
  }

• src/server/mcp-server.ts:94-101 (registration)

  Registers the get_station_details tool in the McpServer class using the MCPTool interface, with schema validation and delegation to NoaaService.

  const getStationDetails: MCPTool = {
    name: "get_station_details",
    description: "Get detailed information about a station",
    inputSchema: GetStationDetailsSchema,
    handler: async (params) => {
      return this.noaaService.getStationDetails(params);
    }
  };

• src/interfaces/noaa.ts:117-121 (schema)

  Zod schema defining input parameters for get_station_details: required station ID, optional units (english/metric), optional format (json/xml).

  export const GetStationDetailsSchema = z.object({
    station: StationSchema,
    units: UnitsSchema,
    format: z.enum(['json', 'xml']).optional().describe('Output format (json, xml)'),
  });

• src/tools/station-tools.ts:37-56 (registration)

  Alternative registration of get_station_details tool using FastMCP's addTool method, with inline Zod parameters schema, error handling, and JSON stringification of result.

  server.addTool({
    name: 'get_station_details',
    description: 'Get detailed information about a station',
    parameters: z.object({
      station: StationSchema,
      format: z.enum(['json', 'xml']).optional().describe('Output format (json, xml)'),
      units: UnitsSchema,
    }),
    execute: async (params) => {
      try {
        const result = await noaaService.getStationDetails(params);
        return JSON.stringify(result);
      } catch (error) {
        if (error instanceof Error) {
          throw new Error(`Failed to get station details: ${error.message}`);
        }
        throw new Error('Failed to get station details');
      }
    }
  });