@squawk/mcp 0.2.0

package/dist/tools/fixes.js

@@ -0,0 +1,108 @@
+/**
+ * @packageDocumentation
+ * MCP tool module wrapping `@squawk/fixes` fix/waypoint lookup methods,
+ * backed by the US NASR snapshot in `@squawk/fix-data`.
+ */
+import { z } from 'zod';
+import { fixResolver } from '../resolvers.js';
+/** All {@link FixUseCode} values, used for input validation. */
+const FIX_USE_CODE_VALUES = [
+    'WP',
+    'RP',
+    'MW',
+    'MR',
+    'CN',
+    'VFR',
+    'NRS',
+    'RADAR',
+];
+/**
+ * Registers fix/waypoint lookup tools on the given MCP server. Uses the
+ * shared {@link fixResolver} built at module load time.
+ *
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerFixTools(server) {
+    server.registerTool('get_fix_by_ident', {
+        title: 'Get fixes by identifier',
+        description: 'Looks up US fixes/waypoints by identifier (e.g. "MERIT", "BOSCO"). Multiple fixes can share the same identifier across ICAO regions, so the result is always an array. Returns an empty array when no match is found.',
+        inputSchema: {
+            ident: z.string().min(1).describe('Fix identifier (case-insensitive).'),
+        },
+    }, ({ ident }) => {
+        const fixes = fixResolver.byIdent(ident);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(fixes, null, 2) }],
+            structuredContent: { fixes },
+        };
+    });
+    server.registerTool('find_nearest_fixes', {
+        title: 'Find nearest fixes',
+        description: 'Finds US fixes/waypoints near a geographic position, sorted by great-circle distance in nautical miles.',
+        inputSchema: {
+            lat: z.number().min(-90).max(90).describe('Latitude in decimal degrees (WGS84).'),
+            lon: z.number().min(-180).max(180).describe('Longitude in decimal degrees (WGS84).'),
+            maxDistanceNm: z
+                .number()
+                .positive()
+                .optional()
+                .describe('Maximum search radius in nautical miles. Defaults to 30.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Maximum number of results to return. Defaults to 10.'),
+            useCodes: z
+                .array(z.enum(FIX_USE_CODE_VALUES))
+                .optional()
+                .describe('Restrict results to these FAA fix-use codes (e.g. WP=waypoint, RP=reporting point, VFR=VFR waypoint). Omit to include all use codes.'),
+        },
+    }, ({ lat, lon, maxDistanceNm, limit, useCodes }) => {
+        const query = { lat, lon };
+        if (maxDistanceNm !== undefined) {
+            query.maxDistanceNm = maxDistanceNm;
+        }
+        if (limit !== undefined) {
+            query.limit = limit;
+        }
+        if (useCodes !== undefined) {
+            query.useCodes = new Set(useCodes);
+        }
+        const results = fixResolver.nearest(query);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+            structuredContent: { results },
+        };
+    });
+    server.registerTool('search_fixes', {
+        title: 'Search fixes by identifier',
+        description: 'Searches US fixes/waypoints by case-insensitive substring matching against the fix identifier. Results are returned in alphabetical order by identifier.',
+        inputSchema: {
+            text: z.string().min(1).describe('Substring to match against the fix identifier.'),
+            useCodes: z
+                .array(z.enum(FIX_USE_CODE_VALUES))
+                .optional()
+                .describe('Restrict results to these FAA fix-use codes. Omit to include all use codes.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Maximum number of results to return. Defaults to 20.'),
+        },
+    }, ({ text, useCodes, limit }) => {
+        const query = { text };
+        if (useCodes !== undefined) {
+            query.useCodes = new Set(useCodes);
+        }
+        if (limit !== undefined) {
+            query.limit = limit;
+        }
+        const fixes = fixResolver.search(query);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(fixes, null, 2) }],
+            structuredContent: { fixes },
+        };
+    });
+}

package/dist/tools/flight-math.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @packageDocumentation
+ * MCP tool module wrapping `@squawk/flight-math` E6B-style flight computer
+ * calculations. Each tool corresponds to a single function from one of the
+ * package's namespaces (atmosphere, airspeed, wind, descent, navigation,
+ * turn, glide, solar, magnetic, planning).
+ *
+ * Trivially-simple operations (single multiplications, divisions, or
+ * trig calls) are intentionally not exposed as tools - LLMs handle those
+ * accurately on their own. The selected tools cover the cases where the
+ * underlying implementation embeds a non-trivial constant, formula, or
+ * lookup (the WMM2025 spherical harmonics, the NOAA solar algorithm,
+ * compressible-flow pitot equations, holding-pattern sector logic, and
+ * so on).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers flight-math computation tools on the given MCP server.
+ *
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerFlightMathTools(server: McpServer): void;
+//# sourceMappingURL=flight-math.d.ts.map

package/dist/tools/flight-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight-math.d.ts","sourceRoot":"","sources":["../../src/tools/flight-math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiFzE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuwB/D"}