@ryancardin/noaa-tides-currents-mcp-server 1.0.0

package/dist/interfaces/noaa.d.ts

@@ -0,0 +1,334 @@
+import { z } from 'zod';
+export declare const GetWaterLevelsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    datum: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>;
+export declare const GetTidePredictionsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    datum: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    interval: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    datum?: string | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>;
+export declare const GetCurrentsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    bin: z.ZodOptional<z.ZodNumber>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}>, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}>;
+export declare const GetCurrentPredictionsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    bin: z.ZodOptional<z.ZodNumber>;
+    interval: z.ZodOptional<z.ZodString>;
+    vel_type: z.ZodOptional<z.ZodEnum<["speed_dir", "default"]>>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}>, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}>;
+export declare const GetMeteorologicalDataSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    product: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    end_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    begin_date?: string | undefined;
+    range?: number | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>;
+export declare const GetStationsSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml"]>>;
+    name: z.ZodOptional<z.ZodString>;
+    lat_min: z.ZodOptional<z.ZodNumber>;
+    lat_max: z.ZodOptional<z.ZodNumber>;
+    lon_min: z.ZodOptional<z.ZodNumber>;
+    lon_max: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodEnum<["name", "id", "state"]>>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    type?: string | undefined;
+    offset?: number | undefined;
+    state?: string | undefined;
+    lat_min?: number | undefined;
+    lat_max?: number | undefined;
+    lon_min?: number | undefined;
+    lon_max?: number | undefined;
+    limit?: number | undefined;
+    sort_by?: "name" | "id" | "state" | undefined;
+    sort_order?: "desc" | "asc" | undefined;
+    format?: "json" | "xml" | undefined;
+    units?: "english" | "metric" | undefined;
+}, {
+    name?: string | undefined;
+    type?: string | undefined;
+    offset?: number | undefined;
+    state?: string | undefined;
+    lat_min?: number | undefined;
+    lat_max?: number | undefined;
+    lon_min?: number | undefined;
+    lon_max?: number | undefined;
+    limit?: number | undefined;
+    sort_by?: "name" | "id" | "state" | undefined;
+    sort_order?: "desc" | "asc" | undefined;
+    format?: "json" | "xml" | undefined;
+    units?: "english" | "metric" | undefined;
+}>;
+export declare const GetStationDetailsSchema: z.ZodObject<{
+    station: z.ZodString;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    format?: "json" | "xml" | undefined;
+    units?: "english" | "metric" | undefined;
+}, {
+    station: string;
+    format?: "json" | "xml" | undefined;
+    units?: "english" | "metric" | undefined;
+}>;
+export type GetWaterLevelsParams = z.infer<typeof GetWaterLevelsSchema>;
+export type GetTidePredictionsParams = z.infer<typeof GetTidePredictionsSchema>;
+export type GetCurrentsParams = z.infer<typeof GetCurrentsSchema>;
+export type GetCurrentPredictionsParams = z.infer<typeof GetCurrentPredictionsSchema>;
+export type GetMeteorologicalDataParams = z.infer<typeof GetMeteorologicalDataSchema>;
+export type GetStationsParams = z.infer<typeof GetStationsSchema>;
+export type GetStationDetailsParams = z.infer<typeof GetStationDetailsSchema>;

package/dist/interfaces/noaa.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+// Common parameter schemas
+const StationSchema = z.string().min(1).describe('Station ID');
+const DateSchema = z.string().optional().describe('Date to retrieve data for ("today", "latest", "recent", or specific date)');
+const BeginDateSchema = z.string().optional().describe('Start date (YYYYMMDD or MM/DD/YYYY)');
+const EndDateSchema = z.string().optional().describe('End date (YYYYMMDD or MM/DD/YYYY)');
+const RangeSchema = z.number().optional().describe('Number of hours to retrieve data for');
+const DatumSchema = z.string().optional().describe('Datum to use (MLLW, MSL, etc.)');
+const UnitsSchema = z.enum(['english', 'metric']).optional().describe('Units to use ("english" or "metric")');
+const TimeZoneSchema = z.enum(['gmt', 'lst', 'lst_ldt']).optional().describe('Time zone (gmt, lst, lst_ldt)');
+const FormatSchema = z.enum(['json', 'xml', 'csv']).optional().describe('Output format (json, xml, csv)');
+const BinSchema = z.number().optional().describe('Bin number');
+const IntervalSchema = z.string().optional().describe('Interval (hilo, hl, h, or a number for minutes)');
+// Water Level Schema
+export const GetWaterLevelsSchema = z.object({
+    station: StationSchema,
+    date: DateSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    range: RangeSchema,
+    datum: DatumSchema,
+    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'" });
+// Tide Predictions Schema
+export const GetTidePredictionsSchema = z.object({
+    station: StationSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    date: DateSchema,
+    range: RangeSchema,
+    datum: DatumSchema,
+    units: UnitsSchema,
+    time_zone: TimeZoneSchema,
+    interval: IntervalSchema,
+    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'" });
+// Currents Schema
+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'" });
+// Current Predictions Schema
+export const GetCurrentPredictionsSchema = z.object({
+    station: StationSchema,
+    date: DateSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    range: RangeSchema,
+    bin: BinSchema,
+    interval: z.string().optional().describe('Interval (MAX_SLACK or a number for minutes)'),
+    vel_type: z.enum(['speed_dir', 'default']).optional().describe('Velocity type (speed_dir or default)'),
+    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'" });
+// Meteorological Data Schema
+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'" });
+// Station List Schema
+export const GetStationsSchema = z.object({
+    type: z.string().optional().describe('Station type (waterlevels, currents, etc.)'),
+    units: UnitsSchema,
+    format: z.enum(['json', 'xml']).optional().describe('Output format (json, xml)'),
+    name: z.string().optional().describe('Filter stations by name (partial match)'),
+    lat_min: z.number().optional().describe('Minimum latitude boundary'),
+    lat_max: z.number().optional().describe('Maximum latitude boundary'),
+    lon_min: z.number().optional().describe('Minimum longitude boundary'),
+    lon_max: z.number().optional().describe('Maximum longitude boundary'),
+    state: z.string().optional().describe('Filter stations by state code (e.g., CA, NY)'),
+    limit: z.number().optional().describe('Maximum number of stations to return'),
+    offset: z.number().optional().describe('Number of stations to skip for pagination'),
+    sort_by: z.enum(['name', 'id', 'state']).optional().describe('Field to sort results by'),
+    sort_order: z.enum(['asc', 'desc']).optional().describe('Sort order (ascending or descending)'),
+});
+// Station Details Schema
+export const GetStationDetailsSchema = z.object({
+    station: StationSchema,
+    units: UnitsSchema,
+    format: z.enum(['json', 'xml']).optional().describe('Output format (json, xml)'),
+});

package/dist/interfaces/parameters.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const ParameterSchema: z.ZodObject<{
+    parameter: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    parameter?: string | undefined;
+}, {
+    parameter?: string | undefined;
+}>;
+export type GetParametersParams = z.infer<typeof ParameterSchema>;
+export interface ParameterInfo {
+    id: string;
+    description: string;
+}
+export interface DateFormatInfo {
+    format: string;
+    description: string;
+    example: string;
+}

package/dist/interfaces/parameters.js

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+// Parameter type schema
+export const ParameterSchema = z.object({
+    parameter: z.string().optional().describe('Parameter type to get information about (time_zones, datums, units, tide_intervals, current_intervals, velocity_types, products, station_types, date_formats, output_formats). If not provided, returns information about all parameter types.')
+});

package/dist/interfaces/sun.d.ts

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { SunEventType } from '../types/sun.js';
+/**
+ * Parameters for getting sun times
+ */
+export declare const SunTimesParamsSchema: z.ZodObject<{
+    date: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    format: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    latitude: number;
+    longitude: number;
+    date?: string | undefined;
+    format?: "text" | "json" | undefined;
+    timezone?: string | undefined;
+}, {
+    latitude: number;
+    longitude: number;
+    date?: string | undefined;
+    format?: "text" | "json" | undefined;
+    timezone?: string | undefined;
+}>;
+export type SunTimesParams = z.infer<typeof SunTimesParamsSchema>;
+/**
+ * Parameters for getting sun times for a date range
+ */
+export declare const SunTimesRangeParamsSchema: z.ZodObject<{
+    start_date: z.ZodString;
+    end_date: z.ZodString;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    format: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    latitude: number;
+    longitude: number;
+    start_date: string;
+    end_date: string;
+    format?: "text" | "json" | undefined;
+    timezone?: string | undefined;
+}, {
+    latitude: number;
+    longitude: number;
+    start_date: string;
+    end_date: string;
+    format?: "text" | "json" | undefined;
+    timezone?: string | undefined;
+}>;
+export type SunTimesRangeParams = z.infer<typeof SunTimesRangeParamsSchema>;
+/**
+ * Parameters for getting sun position
+ */
+export declare const SunPositionParamsSchema: z.ZodObject<{
+    date: z.ZodOptional<z.ZodString>;
+    time: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    format: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
+}, "strip", z.ZodTypeAny, {
+    latitude: number;
+    longitude: number;
+    time?: string | undefined;
+    date?: string | undefined;
+    format?: "text" | "json" | undefined;
+}, {
+    latitude: number;
+    longitude: number;
+    time?: string | undefined;
+    date?: string | undefined;
+    format?: "text" | "json" | undefined;
+}>;
+export type SunPositionParams = z.infer<typeof SunPositionParamsSchema>;
+/**
+ * Parameters for finding the next sun event
+ */
+export declare const NextSunEventParamsSchema: z.ZodObject<{
+    event: z.ZodNativeEnum<typeof SunEventType>;
+    date: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    count: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    event: SunEventType;
+    latitude: number;
+    longitude: number;
+    date?: string | undefined;
+    format?: "text" | "json" | undefined;
+    count?: number | undefined;
+    timezone?: string | undefined;
+}, {
+    event: SunEventType;
+    latitude: number;
+    longitude: number;
+    date?: string | undefined;
+    format?: "text" | "json" | undefined;
+    count?: number | undefined;
+    timezone?: string | undefined;
+}>;
+export type NextSunEventParams = z.infer<typeof NextSunEventParamsSchema>;

package/dist/interfaces/sun.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { SunEventType } from '../types/sun.js';
+/**
+ * Parameters for getting sun times
+ */
+export const SunTimesParamsSchema = z.object({
+    date: z.string().optional().describe('Date to get sun times for (YYYY-MM-DD format). Defaults to current date.'),
+    latitude: z.number().min(-90).max(90).describe('Latitude for location-specific calculations'),
+    longitude: z.number().min(-180).max(180).describe('Longitude for location-specific calculations'),
+    format: z.enum(['json', 'text']).optional().describe('Output format (json or text)'),
+    timezone: z.string().optional().describe('Timezone for the results. Defaults to UTC.')
+});
+/**
+ * Parameters for getting sun times for a date range
+ */
+export const SunTimesRangeParamsSchema = z.object({
+    start_date: z.string().describe('Start date (YYYY-MM-DD format)'),
+    end_date: z.string().describe('End date (YYYY-MM-DD format)'),
+    latitude: z.number().min(-90).max(90).describe('Latitude for location-specific calculations'),
+    longitude: z.number().min(-180).max(180).describe('Longitude for location-specific calculations'),
+    format: z.enum(['json', 'text']).optional().describe('Output format (json or text)'),
+    timezone: z.string().optional().describe('Timezone for the results. Defaults to UTC.')
+});
+/**
+ * Parameters for getting sun position
+ */
+export const SunPositionParamsSchema = z.object({
+    date: z.string().optional().describe('Date to get sun position for (YYYY-MM-DD format). Defaults to current date.'),
+    time: z.string().optional().describe('Time to get sun position for (HH:MM:SS format). Defaults to current time.'),
+    latitude: z.number().min(-90).max(90).describe('Latitude for location-specific calculations'),
+    longitude: z.number().min(-180).max(180).describe('Longitude for location-specific calculations'),
+    format: z.enum(['json', 'text']).optional().describe('Output format (json or text)')
+});
+/**
+ * Parameters for finding the next sun event
+ */
+export const NextSunEventParamsSchema = z.object({
+    event: z.nativeEnum(SunEventType).describe('Sun event to find'),
+    date: z.string().optional().describe('Starting date (YYYY-MM-DD format). Defaults to current date.'),
+    latitude: z.number().min(-90).max(90).describe('Latitude for location-specific calculations'),
+    longitude: z.number().min(-180).max(180).describe('Longitude for location-specific calculations'),
+    count: z.number().positive().optional().describe('Number of occurrences to return. Defaults to 1.'),
+    format: z.enum(['json', 'text']).optional().describe('Output format (json or text)'),
+    timezone: z.string().optional().describe('Timezone for the results. Defaults to UTC.')
+});

package/dist/mcp-server.d.ts

@@ -0,0 +1,12 @@
+import { NoaaService } from './noaa-service.js';
+export declare class McpServer {
+    private tools;
+    private noaaService;
+    constructor(noaaService: NoaaService);
+    private initializeTools;
+    getTools(): {
+        name: string;
+        description: string;
+    }[];
+    executeTool(toolName: string, params: any): Promise<any>;
+}