@mapbox/mcp-server 0.6.1 → 0.8.1-dev.1

package/dist/commonjs/prompts/BasePrompt.js

@@ -0,0 +1,38 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePrompt = void 0;
+/**
+ * Base class for all MCP prompts.
+ *
+ * Prompts are pre-built, parameterized workflows that guide multi-step geospatial tasks.
+ * They capture domain expertise and best practices for common use cases.
+ */
+class BasePrompt {
+    /**
+     * Get the prompt metadata for listing
+     */
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            arguments: this.arguments
+        };
+    }
+    /**
+     * Validate that all required arguments are provided
+     *
+     * @param args - The argument values to validate
+     * @throws Error if required arguments are missing
+     */
+    validateArguments(args) {
+        for (const arg of this.arguments) {
+            if (arg.required && !args[arg.name]) {
+                throw new Error(`Missing required argument: ${arg.name}`);
+            }
+        }
+    }
+}
+exports.BasePrompt = BasePrompt;
+//# sourceMappingURL=BasePrompt.js.map

package/dist/commonjs/prompts/BasePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePrompt.js","sourceRoot":"","sources":["../../../src/prompts/BasePrompt.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAQlC;;;;;GAKG;AACH,MAAsB,UAAU;IAgB9B;;OAEG;IACH,WAAW;QACT,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAUD;;;;;OAKG;IACO,iBAAiB,CAAC,IAA4B;QACtD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAhDD,gCAgDC"}

package/dist/commonjs/prompts/FindPlacesNearbyPrompt.d.ts

@@ -0,0 +1,22 @@
+import { BasePrompt } from './BasePrompt.js';
+import type { PromptArgument, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Prompt for finding places near a location with optional map visualization.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the location (if needed)
+ * 2. Searching for places by category
+ * 3. Formatting results with map visualization
+ *
+ * Example queries:
+ * - "Find coffee shops near downtown Seattle"
+ * - "Show me restaurants near 123 Main St"
+ * - "What museums are near the Eiffel Tower?"
+ */
+export declare class FindPlacesNearbyPrompt extends BasePrompt {
+    readonly name = "find-places-nearby";
+    readonly description = "Helps you search for specific types of places near a location with optional map visualization";
+    readonly arguments: PromptArgument[];
+    getMessages(args: Record<string, string>): PromptMessage[];
+}
+//# sourceMappingURL=FindPlacesNearbyPrompt.d.ts.map

package/dist/commonjs/prompts/FindPlacesNearbyPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindPlacesNearbyPrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/FindPlacesNearbyPrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,WAAW,mGAC8E;IAElG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAkBlC;IAEF,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;CAyB3D"}

package/dist/commonjs/prompts/FindPlacesNearbyPrompt.js

@@ -0,0 +1,65 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FindPlacesNearbyPrompt = void 0;
+const BasePrompt_js_1 = require("./BasePrompt.js");
+/**
+ * Prompt for finding places near a location with optional map visualization.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the location (if needed)
+ * 2. Searching for places by category
+ * 3. Formatting results with map visualization
+ *
+ * Example queries:
+ * - "Find coffee shops near downtown Seattle"
+ * - "Show me restaurants near 123 Main St"
+ * - "What museums are near the Eiffel Tower?"
+ */
+class FindPlacesNearbyPrompt extends BasePrompt_js_1.BasePrompt {
+    name = 'find-places-nearby';
+    description = 'Helps you search for specific types of places near a location with optional map visualization';
+    arguments = [
+        {
+            name: 'location',
+            description: 'The location to search near (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'category',
+            description: 'Type of place to search for (e.g., "coffee shops", "restaurants", "museums")',
+            required: false
+        },
+        {
+            name: 'radius',
+            description: 'Search radius in meters (default: 1000)',
+            required: false
+        }
+    ];
+    getMessages(args) {
+        this.validateArguments(args);
+        const { location, category, radius } = args;
+        const radiusText = radius ? ` within ${radius} meters` : '';
+        const categoryText = category || 'places';
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Find ${categoryText} near ${location}${radiusText}.
+
+Please follow these steps:
+1. If the location is not in coordinate format, geocode it first using search_and_geocode_tool
+2. Use category_search_tool or search_tool to find ${categoryText} near the location
+3. Display the results on a map showing the location and the found places
+4. Provide a summary of the top results with key details (name, address, distance)
+
+Make the output clear and actionable.`
+                }
+            }
+        ];
+    }
+}
+exports.FindPlacesNearbyPrompt = FindPlacesNearbyPrompt;
+//# sourceMappingURL=FindPlacesNearbyPrompt.js.map

package/dist/commonjs/prompts/FindPlacesNearbyPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindPlacesNearbyPrompt.js","sourceRoot":"","sources":["../../../src/prompts/FindPlacesNearbyPrompt.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,mDAA6C;AAM7C;;;;;;;;;;;;GAYG;AACH,MAAa,sBAAuB,SAAQ,0BAAU;IAC3C,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAClB,+FAA+F,CAAC;IAEzF,SAAS,GAAqB;QACrC;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,mEAAmE;YACrE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,8EAA8E;YAChF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEF,WAAW,CAAC,IAA4B;QACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG,QAAQ,IAAI,QAAQ,CAAC;QAE1C,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ,YAAY,SAAS,QAAQ,GAAG,UAAU;;;;qDAIb,YAAY;;;;sCAI3B;iBAC7B;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAlDD,wDAkDC"}

package/dist/commonjs/prompts/GetDirectionsPrompt.d.ts

@@ -0,0 +1,23 @@
+import { BasePrompt } from './BasePrompt.js';
+import type { PromptArgument, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Prompt for getting turn-by-turn directions between two locations.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding start and end locations (if needed)
+ * 2. Getting directions via the appropriate routing profile
+ * 3. Visualizing the route on a map
+ * 4. Providing clear turn-by-turn instructions
+ *
+ * Example queries:
+ * - "Get directions from my office to the airport"
+ * - "How do I drive from Seattle to Portland?"
+ * - "Walking directions from here to the museum"
+ */
+export declare class GetDirectionsPrompt extends BasePrompt {
+    readonly name = "get-directions";
+    readonly description = "Provides turn-by-turn directions between two locations with options for different travel modes";
+    readonly arguments: PromptArgument[];
+    getMessages(args: Record<string, string>): PromptMessage[];
+}
+//# sourceMappingURL=GetDirectionsPrompt.d.ts.map

package/dist/commonjs/prompts/GetDirectionsPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetDirectionsPrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/GetDirectionsPrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,oGAC+E;IAEnG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAiBlC;IAEF,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;CA0B3D"}

package/dist/commonjs/prompts/GetDirectionsPrompt.js

@@ -0,0 +1,67 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetDirectionsPrompt = void 0;
+const BasePrompt_js_1 = require("./BasePrompt.js");
+/**
+ * Prompt for getting turn-by-turn directions between two locations.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding start and end locations (if needed)
+ * 2. Getting directions via the appropriate routing profile
+ * 3. Visualizing the route on a map
+ * 4. Providing clear turn-by-turn instructions
+ *
+ * Example queries:
+ * - "Get directions from my office to the airport"
+ * - "How do I drive from Seattle to Portland?"
+ * - "Walking directions from here to the museum"
+ */
+class GetDirectionsPrompt extends BasePrompt_js_1.BasePrompt {
+    name = 'get-directions';
+    description = 'Provides turn-by-turn directions between two locations with options for different travel modes';
+    arguments = [
+        {
+            name: 'from',
+            description: 'Starting location (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'to',
+            description: 'Destination location (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'mode',
+            description: 'Travel mode: driving, walking, or cycling (default: driving)',
+            required: false
+        }
+    ];
+    getMessages(args) {
+        this.validateArguments(args);
+        const { from, to, mode = 'driving' } = args;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Get ${mode} directions from ${from} to ${to}.
+
+Please follow these steps:
+1. Geocode both the starting point and destination if they're not in coordinate format
+2. Use directions_tool to get the route with profile set to ${mode}
+3. Display the route on a map with clear start and end markers
+4. Provide:
+   - Total distance and estimated travel time
+   - Turn-by-turn directions (summarized if very long)
+   - Any notable features along the route (tolls, ferries, etc.)
+
+Format the output to be clear and easy to follow.`
+                }
+            }
+        ];
+    }
+}
+exports.GetDirectionsPrompt = GetDirectionsPrompt;
+//# sourceMappingURL=GetDirectionsPrompt.js.map

package/dist/commonjs/prompts/GetDirectionsPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetDirectionsPrompt.js","sourceRoot":"","sources":["../../../src/prompts/GetDirectionsPrompt.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,mDAA6C;AAM7C;;;;;;;;;;;;;GAaG;AACH,MAAa,mBAAoB,SAAQ,0BAAU;IACxC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAClB,gGAAgG,CAAC;IAE1F,SAAS,GAAqB;QACrC;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,8DAA8D;YAChE,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEF,WAAW,CAAC,IAA4B;QACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;QAE5C,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO,IAAI,oBAAoB,IAAI,OAAO,EAAE;;;;8DAIE,IAAI;;;;;;;kDAOhB;iBACzC;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAlDD,kDAkDC"}

package/dist/commonjs/prompts/ShowReachableAreasPrompt.d.ts

@@ -0,0 +1,23 @@
+import { BasePrompt } from './BasePrompt.js';
+import type { PromptArgument, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Prompt for visualizing areas reachable within a specified time from a location.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the starting location (if needed)
+ * 2. Calculating isochrones for the specified travel time
+ * 3. Visualizing the reachable areas on a map
+ * 4. Providing context about what the isochrone represents
+ *
+ * Example queries:
+ * - "Show me areas I can reach in 15 minutes from downtown"
+ * - "What's the 30-minute driving range from our warehouse?"
+ * - "Display my 10-minute walk radius from home"
+ */
+export declare class ShowReachableAreasPrompt extends BasePrompt {
+    readonly name = "show-reachable-areas";
+    readonly description = "Visualizes areas that can be reached from a location within a specified time using isochrones";
+    readonly arguments: PromptArgument[];
+    getMessages(args: Record<string, string>): PromptMessage[];
+}
+//# sourceMappingURL=ShowReachableAreasPrompt.d.ts.map

package/dist/commonjs/prompts/ShowReachableAreasPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowReachableAreasPrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/ShowReachableAreasPrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;IACtD,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,WAAW,mGAC8E;IAElG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAiBlC;IAEF,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;CA6B3D"}

package/dist/commonjs/prompts/ShowReachableAreasPrompt.js

@@ -0,0 +1,70 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShowReachableAreasPrompt = void 0;
+const BasePrompt_js_1 = require("./BasePrompt.js");
+/**
+ * Prompt for visualizing areas reachable within a specified time from a location.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the starting location (if needed)
+ * 2. Calculating isochrones for the specified travel time
+ * 3. Visualizing the reachable areas on a map
+ * 4. Providing context about what the isochrone represents
+ *
+ * Example queries:
+ * - "Show me areas I can reach in 15 minutes from downtown"
+ * - "What's the 30-minute driving range from our warehouse?"
+ * - "Display my 10-minute walk radius from home"
+ */
+class ShowReachableAreasPrompt extends BasePrompt_js_1.BasePrompt {
+    name = 'show-reachable-areas';
+    description = 'Visualizes areas that can be reached from a location within a specified time using isochrones';
+    arguments = [
+        {
+            name: 'location',
+            description: 'Starting location (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'time_minutes',
+            description: 'Travel time in minutes (default: 15)',
+            required: false
+        },
+        {
+            name: 'mode',
+            description: 'Travel mode: driving, walking, or cycling (default: driving)',
+            required: false
+        }
+    ];
+    getMessages(args) {
+        this.validateArguments(args);
+        const { location, time_minutes = '15', mode = 'driving' } = args;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Show areas reachable within ${time_minutes} minutes of ${mode} from ${location}.
+
+Please follow these steps:
+1. Geocode the location if it's not in coordinate format
+2. Use isochrone_tool to calculate the ${time_minutes}-minute ${mode} isochrone
+3. Visualize the reachable area on a map with:
+   - The starting location clearly marked
+   - The isochrone polygon showing the reachable area
+   - Appropriate styling to make it easy to understand
+4. Provide context explaining:
+   - What area is covered (approximate square miles/km)
+   - What this means practically (e.g., "You can reach X locations within ${time_minutes} minutes")
+   - Any limitations or caveats (traffic conditions, time of day, etc.)
+
+Make the visualization clear and the explanation actionable.`
+                }
+            }
+        ];
+    }
+}
+exports.ShowReachableAreasPrompt = ShowReachableAreasPrompt;
+//# sourceMappingURL=ShowReachableAreasPrompt.js.map

package/dist/commonjs/prompts/ShowReachableAreasPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowReachableAreasPrompt.js","sourceRoot":"","sources":["../../../src/prompts/ShowReachableAreasPrompt.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,mDAA6C;AAM7C;;;;;;;;;;;;;GAaG;AACH,MAAa,wBAAyB,SAAQ,0BAAU;IAC7C,IAAI,GAAG,sBAAsB,CAAC;IAC9B,WAAW,GAClB,+FAA+F,CAAC;IAEzF,SAAS,GAAqB;QACrC;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,sCAAsC;YACnD,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,8DAA8D;YAChE,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEF,WAAW,CAAC,IAA4B;QACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;QAEjE,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,+BAA+B,YAAY,eAAe,IAAI,SAAS,QAAQ;;;;yCAItD,YAAY,WAAW,IAAI;;;;;;;4EAOQ,YAAY;;;6DAG3B;iBACpD;aACF;SACF,CAAC;IACJ,CAAC;CACF;AArDD,4DAqDC"}

package/dist/commonjs/prompts/promptRegistry.d.ts

@@ -0,0 +1,29 @@
+import { FindPlacesNearbyPrompt } from './FindPlacesNearbyPrompt.js';
+import { GetDirectionsPrompt } from './GetDirectionsPrompt.js';
+import { ShowReachableAreasPrompt } from './ShowReachableAreasPrompt.js';
+/**
+ * Central registry of all available prompts.
+ *
+ * This module maintains a readonly collection of prompt instances and provides
+ * type-safe access methods.
+ */
+declare const ALL_PROMPTS: readonly [FindPlacesNearbyPrompt, GetDirectionsPrompt, ShowReachableAreasPrompt];
+/**
+ * Type representing any prompt instance
+ */
+export type PromptInstance = (typeof ALL_PROMPTS)[number];
+/**
+ * Get all registered prompts
+ *
+ * @returns Readonly array of all prompt instances
+ */
+export declare function getAllPrompts(): readonly PromptInstance[];
+/**
+ * Get a prompt by name
+ *
+ * @param name - The prompt name to look up
+ * @returns The prompt instance, or undefined if not found
+ */
+export declare function getPromptByName(name: string): PromptInstance | undefined;
+export {};
+//# sourceMappingURL=promptRegistry.d.ts.map

package/dist/commonjs/prompts/promptRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptRegistry.d.ts","sourceRoot":"","sources":["../../../src/prompts/promptRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE;;;;;GAKG;AAGH,QAAA,MAAM,WAAW,kFAIP,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,SAAS,cAAc,EAAE,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE"}

package/dist/commonjs/prompts/promptRegistry.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllPrompts = getAllPrompts;
+exports.getPromptByName = getPromptByName;
+const FindPlacesNearbyPrompt_js_1 = require("./FindPlacesNearbyPrompt.js");
+const GetDirectionsPrompt_js_1 = require("./GetDirectionsPrompt.js");
+const ShowReachableAreasPrompt_js_1 = require("./ShowReachableAreasPrompt.js");
+/**
+ * Central registry of all available prompts.
+ *
+ * This module maintains a readonly collection of prompt instances and provides
+ * type-safe access methods.
+ */
+// Instantiate all prompts
+const ALL_PROMPTS = [
+    new FindPlacesNearbyPrompt_js_1.FindPlacesNearbyPrompt(),
+    new GetDirectionsPrompt_js_1.GetDirectionsPrompt(),
+    new ShowReachableAreasPrompt_js_1.ShowReachableAreasPrompt()
+];
+/**
+ * Get all registered prompts
+ *
+ * @returns Readonly array of all prompt instances
+ */
+function getAllPrompts() {
+    return ALL_PROMPTS;
+}
+/**
+ * Get a prompt by name
+ *
+ * @param name - The prompt name to look up
+ * @returns The prompt instance, or undefined if not found
+ */
+function getPromptByName(name) {
+    return ALL_PROMPTS.find((prompt) => prompt.name === name);
+}
+//# sourceMappingURL=promptRegistry.js.map

package/dist/commonjs/prompts/promptRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptRegistry.js","sourceRoot":"","sources":["../../../src/prompts/promptRegistry.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;AA8BlC,sCAEC;AAQD,0CAEC;AAxCD,2EAAqE;AACrE,qEAA+D;AAC/D,+EAAyE;AAEzE;;;;;GAKG;AAEH,0BAA0B;AAC1B,MAAM,WAAW,GAAG;IAClB,IAAI,kDAAsB,EAAE;IAC5B,IAAI,4CAAmB,EAAE;IACzB,IAAI,sDAAwB,EAAE;CACtB,CAAC;AAOX;;;;GAIG;AACH,SAAgB,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5D,CAAC"}

package/dist/commonjs/resources/BaseResource.d.ts

@@ -0,0 +1,28 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ServerRequest, ServerNotification, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Base class for all MCP resources
+ */
+export declare abstract class BaseResource {
+    abstract readonly uri: string;
+    abstract readonly name: string;
+    abstract readonly description?: string;
+    abstract readonly mimeType?: string;
+    protected server: McpServer | null;
+    /**
+     * Installs the resource to the given MCP server.
+     */
+    installTo(server: McpServer): void;
+    /**
+     * Resource read logic to be implemented by subclasses.
+     * @param uri The resource URI as a string
+     * @param extra Additional request context
+     */
+    abstract read(uri: string, extra?: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult>;
+    /**
+     * Helper method to send logging messages
+     */
+    protected log(level: 'debug' | 'info' | 'warning' | 'error', data: unknown): void;
+}
+//# sourceMappingURL=BaseResource.d.ts.map

package/dist/commonjs/resources/BaseResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseResource.d.ts","sourceRoot":"","sources":["../../../src/resources/BaseResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,8BAAsB,YAAY;IAChC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEpC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAmBlC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CACX,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,OAAO,GACZ,IAAI;CAKR"}

package/dist/commonjs/resources/BaseResource.js

@@ -0,0 +1,32 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseResource = void 0;
+/**
+ * Base class for all MCP resources
+ */
+class BaseResource {
+    server = null;
+    /**
+     * Installs the resource to the given MCP server.
+     */
+    installTo(server) {
+        this.server = server;
+        server.registerResource(this.name, this.uri, {
+            title: this.name,
+            description: this.description,
+            mimeType: this.mimeType
+        }, (uri, extra) => this.read(uri.toString(), extra));
+    }
+    /**
+     * Helper method to send logging messages
+     */
+    log(level, data) {
+        if (this.server?.server) {
+            void this.server.server.sendLoggingMessage({ level, data });
+        }
+    }
+}
+exports.BaseResource = BaseResource;
+//# sourceMappingURL=BaseResource.js.map

package/dist/commonjs/resources/BaseResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseResource.js","sourceRoot":"","sources":["../../../src/resources/BaseResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAUlC;;GAEG;AACH,MAAsB,YAAY;IAMtB,MAAM,GAAqB,IAAI,CAAC;IAE1C;;OAEG;IACH,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,CAAC,gBAAgB,CACrB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,GAAG,EACR;YACE,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,EAED,CACE,GAAQ,EACR,KAA6D,EAC7D,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CACtC,CAAC;IACJ,CAAC;IAYD;;OAEG;IACO,GAAG,CACX,KAA6C,EAC7C,IAAa;QAEb,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAnDD,oCAmDC"}

package/dist/commonjs/resources/MapboxApiBasedResource.d.ts

@@ -0,0 +1,35 @@
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ServerRequest, ServerNotification, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import { BaseResource } from './BaseResource.js';
+import type { HttpRequest } from '../utils/types.js';
+/**
+ * Base class for Mapbox API-based resources
+ */
+export declare abstract class MapboxApiBasedResource extends BaseResource {
+    abstract readonly uri: string;
+    abstract readonly name: string;
+    abstract readonly description?: string;
+    abstract readonly mimeType?: string;
+    static get mapboxAccessToken(): string | undefined;
+    static get mapboxApiEndpoint(): string;
+    protected httpRequest: HttpRequest;
+    constructor(params: {
+        httpRequest: HttpRequest;
+    });
+    /**
+     * Validates if a string has the format of a JWT token (header.payload.signature)
+     * Docs: https://docs.mapbox.com/api/accounts/tokens/#token-format
+     * @param token The token string to validate
+     * @returns boolean indicating if the token has valid JWT format
+     */
+    private isValidJwtFormat;
+    /**
+     * Validates and reads the resource.
+     */
+    read(uri: string, extra?: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult>;
+    /**
+     * Resource-specific logic to be implemented by subclasses.
+     */
+    protected abstract execute(uri: string, accessToken: string): Promise<ReadResourceResult>;
+}
+//# sourceMappingURL=MapboxApiBasedResource.d.ts.map

package/dist/commonjs/resources/MapboxApiBasedResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxApiBasedResource.d.ts","sourceRoot":"","sources":["../../../src/resources/MapboxApiBasedResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;GAEG;AACH,8BAAsB,sBAAuB,SAAQ,YAAY;IAC/D,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEpC,MAAM,KAAK,iBAAiB,uBAE3B;IAED,MAAM,KAAK,iBAAiB,WAE3B;IAED,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBAEvB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKhD;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;IA4D9B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CACxB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;CAC/B"}

package/dist/commonjs/resources/MapboxApiBasedResource.js

@@ -0,0 +1,88 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapboxApiBasedResource = void 0;
+const BaseResource_js_1 = require("./BaseResource.js");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../utils/tracing.js");
+/**
+ * Base class for Mapbox API-based resources
+ */
+class MapboxApiBasedResource extends BaseResource_js_1.BaseResource {
+    static get mapboxAccessToken() {
+        return process.env.MAPBOX_ACCESS_TOKEN;
+    }
+    static get mapboxApiEndpoint() {
+        return process.env.MAPBOX_API_ENDPOINT || 'https://api.mapbox.com/';
+    }
+    httpRequest;
+    constructor(params) {
+        super();
+        this.httpRequest = params.httpRequest;
+    }
+    /**
+     * Validates if a string has the format of a JWT token (header.payload.signature)
+     * Docs: https://docs.mapbox.com/api/accounts/tokens/#token-format
+     * @param token The token string to validate
+     * @returns boolean indicating if the token has valid JWT format
+     */
+    isValidJwtFormat(token) {
+        // JWT consists of three parts separated by dots: header.payload.signature
+        const parts = token.split('.');
+        if (parts.length !== 3)
+            return false;
+        // Check that all parts are non-empty
+        return parts.every((part) => part.length > 0);
+    }
+    /**
+     * Validates and reads the resource.
+     */
+    async read(uri, extra) {
+        // First check if token is provided via authentication context
+        const authToken = extra?.authInfo?.token;
+        const accessToken = authToken || MapboxApiBasedResource.mapboxAccessToken;
+        if (!accessToken) {
+            const errorMessage = 'No access token available. Please provide via Bearer auth or MAPBOX_ACCESS_TOKEN env var';
+            this.log('error', `${this.name}: ${errorMessage}`);
+            throw new Error(errorMessage);
+        }
+        // Validate that the token has the correct JWT format
+        if (!this.isValidJwtFormat(accessToken)) {
+            const errorMessage = 'Access token is not in valid JWT format';
+            this.log('error', `${this.name}: ${errorMessage}`);
+            throw new Error(errorMessage);
+        }
+        const tracer = (0, tracing_js_1.getTracer)();
+        const span = tracer.startSpan(`resource.read.${this.name}`, {
+            attributes: {
+                'resource.uri': uri,
+                'resource.name': this.name,
+                'operation.type': 'resource_read'
+            }
+        });
+        try {
+            // Execute within the span context
+            const result = await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), async () => {
+                return await this.execute(uri, accessToken);
+            });
+            // Mark span as successful and end it
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            span.end();
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
+            // Mark span as failed and end it
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: errorMessage
+            });
+            span.end();
+            throw error;
+        }
+    }
+}
+exports.MapboxApiBasedResource = MapboxApiBasedResource;
+//# sourceMappingURL=MapboxApiBasedResource.js.map

package/dist/commonjs/resources/MapboxApiBasedResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxApiBasedResource.js","sourceRoot":"","sources":["../../../src/resources/MapboxApiBasedResource.ts"],"names":[],"mappings":"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"}