@mapbox/mcp-server 0.5.5 → 0.8.1-dev.0

package/dist/esm/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/esm/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/esm/prompts/promptRegistry.js

@@ -0,0 +1,35 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+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.
+ */
+// Instantiate all prompts
+const ALL_PROMPTS = [
+    new FindPlacesNearbyPrompt(),
+    new GetDirectionsPrompt(),
+    new ShowReachableAreasPrompt()
+];
+/**
+ * Get all registered prompts
+ *
+ * @returns Readonly array of all prompt instances
+ */
+export 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
+ */
+export function getPromptByName(name) {
+    return ALL_PROMPTS.find((prompt) => prompt.name === name);
+}
+//# sourceMappingURL=promptRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptRegistry.js","sourceRoot":"","sources":["../../../src/prompts/promptRegistry.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,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;AAEH,0BAA0B;AAC1B,MAAM,WAAW,GAAG;IAClB,IAAI,sBAAsB,EAAE;IAC5B,IAAI,mBAAmB,EAAE;IACzB,IAAI,wBAAwB,EAAE;CACtB,CAAC;AAOX;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,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/esm/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/esm/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/esm/resources/BaseResource.js

@@ -0,0 +1,28 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+/**
+ * Base class for all MCP resources
+ */
+export 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 });
+        }
+    }
+}
+//# sourceMappingURL=BaseResource.js.map

package/dist/esm/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,MAAM,OAAgB,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"}

package/dist/esm/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/esm/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/esm/resources/MapboxApiBasedResource.js

@@ -0,0 +1,84 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { BaseResource } from './BaseResource.js';
+import { context, trace, SpanStatusCode } from '@opentelemetry/api';
+import { getTracer } from '../utils/tracing.js';
+/**
+ * Base class for Mapbox API-based resources
+ */
+export class MapboxApiBasedResource extends 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 = 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 context.with(trace.setSpan(context.active(), span), async () => {
+                return await this.execute(uri, accessToken);
+            });
+            // Mark span as successful and end it
+            span.setStatus({ code: 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: SpanStatusCode.ERROR,
+                message: errorMessage
+            });
+            span.end();
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=MapboxApiBasedResource.js.map

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

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

package/dist/esm/resources/category-list/CategoryListResource.d.ts

@@ -0,0 +1,27 @@
+import { MapboxApiBasedResource } from '../MapboxApiBasedResource.js';
+import type { HttpRequest } from '../../utils/types.js';
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Resource for retrieving the list of supported categories from Mapbox Search API
+ *
+ * Available URIs:
+ * - mapbox://categories - Default (English)
+ * - mapbox://categories/{language} - Localized (e.g., mapbox://categories/ja)
+ */
+export declare class CategoryListResource extends MapboxApiBasedResource {
+    readonly uri = "mapbox://categories";
+    readonly name = "Mapbox Categories";
+    readonly description = "List of all available Mapbox Search API categories. Categories can be used for filtering search results. Supports localization via language parameter in URI (e.g., mapbox://categories/ja for Japanese).";
+    readonly mimeType = "application/json";
+    constructor(params: {
+        httpRequest: HttpRequest;
+    });
+    protected execute(uri: string, accessToken: string): Promise<ReadResourceResult>;
+    /**
+     * Extract language code from URI
+     * @param uri Resource URI (e.g., mapbox://categories/ja)
+     * @returns Language code or undefined if not present
+     */
+    private extractLanguageFromUri;
+}
+//# sourceMappingURL=CategoryListResource.d.ts.map

package/dist/esm/resources/category-list/CategoryListResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryListResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/category-list/CategoryListResource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAiB7E;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC9D,QAAQ,CAAC,GAAG,yBAAyB;IACrC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,+MAC0L;IAC9M,QAAQ,CAAC,QAAQ,sBAAsB;gBAE3B,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;cAIhC,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;IAmD9B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAI/B"}

package/dist/esm/resources/category-list/CategoryListResource.js

@@ -0,0 +1,67 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { MapboxApiBasedResource } from '../MapboxApiBasedResource.js';
+// API Documentation: https://docs.mapbox.com/api/search/search-box/#list-categories
+/**
+ * Resource for retrieving the list of supported categories from Mapbox Search API
+ *
+ * Available URIs:
+ * - mapbox://categories - Default (English)
+ * - mapbox://categories/{language} - Localized (e.g., mapbox://categories/ja)
+ */
+export class CategoryListResource extends MapboxApiBasedResource {
+    uri = 'mapbox://categories';
+    name = 'Mapbox Categories';
+    description = 'List of all available Mapbox Search API categories. Categories can be used for filtering search results. Supports localization via language parameter in URI (e.g., mapbox://categories/ja for Japanese).';
+    mimeType = 'application/json';
+    constructor(params) {
+        super(params);
+    }
+    async execute(uri, accessToken) {
+        // Parse language from URI if present
+        // Format: mapbox://categories or mapbox://categories/ja
+        const language = this.extractLanguageFromUri(uri);
+        const apiUrl = new URL('https://api.mapbox.com/search/searchbox/v1/list/category');
+        apiUrl.searchParams.set('access_token', accessToken);
+        if (language) {
+            apiUrl.searchParams.set('language', language);
+        }
+        const response = await this.httpRequest(apiUrl.toString(), {
+            method: 'GET',
+            headers: {
+                'User-Agent': `@mapbox/mcp-server/${process.env.npm_package_version || 'dev'}`
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Mapbox API request failed: ${response.status} ${response.statusText}`);
+        }
+        const rawData = await response.json();
+        const data = rawData;
+        // Extract just the category IDs for a simplified response
+        const categoryIds = data.listItems.map((item) => item.canonical_id);
+        const result = {
+            listItems: categoryIds,
+            version: data.version,
+            attribution: data.attribution
+        };
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(result, null, 2)
+                }
+            ]
+        };
+    }
+    /**
+     * Extract language code from URI
+     * @param uri Resource URI (e.g., mapbox://categories/ja)
+     * @returns Language code or undefined if not present
+     */
+    extractLanguageFromUri(uri) {
+        const match = uri.match(/^mapbox:\/\/categories\/([a-z]{2})$/i);
+        return match?.[1];
+    }
+}
+//# sourceMappingURL=CategoryListResource.js.map

package/dist/esm/resources/category-list/CategoryListResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryListResource.js","sourceRoot":"","sources":["../../../../src/resources/category-list/CategoryListResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAiBtE,oFAAoF;AAEpF;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IACrD,GAAG,GAAG,qBAAqB,CAAC;IAC5B,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAClB,2MAA2M,CAAC;IACrM,QAAQ,GAAG,kBAAkB,CAAC;IAEvC,YAAY,MAAoC;QAC9C,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAES,KAAK,CAAC,OAAO,CACrB,GAAW,EACX,WAAmB;QAEnB,qCAAqC;QACrC,wDAAwD;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,0DAA0D,CAC3D,CAAC;QAEF,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;YACzD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,YAAY,EAAE,sBAAsB,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,KAAK,EAAE;aAC/E;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,OAA4B,CAAC;QAE1C,0DAA0D;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG;oBACH,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,sBAAsB,CAAC,GAAW;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAChE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;CACF"}

package/dist/esm/resources/resourceRegistry.d.ts

@@ -0,0 +1,6 @@
+import { CategoryListResource } from './category-list/CategoryListResource.js';
+export declare const ALL_RESOURCES: readonly [CategoryListResource];
+export type ResourceInstance = (typeof ALL_RESOURCES)[number];
+export declare function getAllResources(): readonly ResourceInstance[];
+export declare function getResourceByUri(uri: string): ResourceInstance | undefined;
+//# sourceMappingURL=resourceRegistry.d.ts.map

package/dist/esm/resources/resourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.d.ts","sourceRoot":"","sources":["../../../src/resources/resourceRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAI/E,eAAO,MAAM,aAAa,iCAGhB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,wBAAgB,eAAe,IAAI,SAAS,gBAAgB,EAAE,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAY1E"}

package/dist/esm/resources/resourceRegistry.js

@@ -0,0 +1,27 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+// INSERT NEW RESOURCE IMPORT HERE
+import { CategoryListResource } from './category-list/CategoryListResource.js';
+import { httpRequest } from '../utils/httpPipeline.js';
+// Central registry of all resources
+export const ALL_RESOURCES = [
+    // INSERT NEW RESOURCE INSTANCE HERE
+    new CategoryListResource({ httpRequest })
+];
+export function getAllResources() {
+    return ALL_RESOURCES;
+}
+export function getResourceByUri(uri) {
+    // Find exact match first
+    const exactMatch = ALL_RESOURCES.find((resource) => resource.uri === uri);
+    if (exactMatch)
+        return exactMatch;
+    // Find pattern match (e.g., mapbox://categories/ja matches mapbox://categories)
+    return ALL_RESOURCES.find((resource) => {
+        // Check if the URI starts with the resource's base URI
+        const basePattern = resource.uri.replace(/\*/g, '.*');
+        const regex = new RegExp(`^${basePattern}`);
+        return regex.test(uri);
+    });
+}
+//# sourceMappingURL=resourceRegistry.js.map

package/dist/esm/resources/resourceRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.js","sourceRoot":"","sources":["../../../src/resources/resourceRegistry.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,kCAAkC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,oCAAoC;IACpC,IAAI,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC;CACjC,CAAC;AAIX,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,yBAAyB;IACzB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1E,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,gFAAgF;IAChF,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACrC,uDAAuD;QACvD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/schemas/geojson.d.ts

@@ -0,0 +1,115 @@
+/**
+ * GeoJSON interfaces based on RFC 7946
+ * https://tools.ietf.org/html/rfc7946
+ */
+export type GeoJSONGeometryType = 'Point' | 'LineString' | 'Polygon' | 'MultiPoint' | 'MultiLineString' | 'MultiPolygon' | 'GeometryCollection';
+export type GeoJSONFeatureType = 'Feature';
+export type GeoJSONFeatureCollectionType = 'FeatureCollection';
+export type GeoJSONType = GeoJSONGeometryType | GeoJSONFeatureType | GeoJSONFeatureCollectionType;
+/**
+ * Position array [longitude, latitude] or [longitude, latitude, elevation]
+ */
+export type Position = [number, number] | [number, number, number];
+/**
+ * Base interface for all GeoJSON objects
+ */
+export interface GeoJSONBase {
+    type: GeoJSONType;
+    bbox?: [number, number, number, number] | [number, number, number, number, number, number];
+}
+/**
+ * Point geometry
+ */
+export interface Point extends GeoJSONBase {
+    type: 'Point';
+    coordinates: Position;
+}
+/**
+ * LineString geometry
+ */
+export interface LineString extends GeoJSONBase {
+    type: 'LineString';
+    coordinates: Position[];
+}
+/**
+ * Polygon geometry
+ */
+export interface Polygon extends GeoJSONBase {
+    type: 'Polygon';
+    coordinates: Position[][];
+}
+/**
+ * MultiPoint geometry
+ */
+export interface MultiPoint extends GeoJSONBase {
+    type: 'MultiPoint';
+    coordinates: Position[];
+}
+/**
+ * MultiLineString geometry
+ */
+export interface MultiLineString extends GeoJSONBase {
+    type: 'MultiLineString';
+    coordinates: Position[][];
+}
+/**
+ * MultiPolygon geometry
+ */
+export interface MultiPolygon extends GeoJSONBase {
+    type: 'MultiPolygon';
+    coordinates: Position[][][];
+}
+/**
+ * GeometryCollection
+ */
+export interface GeometryCollection extends GeoJSONBase {
+    type: 'GeometryCollection';
+    geometries: Geometry[];
+}
+/**
+ * Union of all geometry types
+ */
+export type Geometry = Point | LineString | Polygon | MultiPoint | MultiLineString | MultiPolygon | GeometryCollection;
+/**
+ * GeoJSON Feature with properties
+ */
+export interface Feature<P = Record<string, unknown>, G extends Geometry = Geometry> extends GeoJSONBase {
+    type: 'Feature';
+    geometry: G | null;
+    properties: P | null;
+    id?: string | number;
+}
+/**
+ * GeoJSON FeatureCollection
+ */
+export interface FeatureCollection<P = Record<string, unknown>, G extends Geometry = Geometry> extends GeoJSONBase {
+    type: 'FeatureCollection';
+    features: Feature<P, G>[];
+}
+/**
+ * Union of all GeoJSON objects
+ */
+export type GeoJSON = Geometry | Feature | FeatureCollection;
+/**
+ * Mapbox-specific properties commonly found in Mapbox API responses
+ */
+export interface MapboxFeatureProperties extends Record<string, unknown> {
+    name?: string;
+    name_preferred?: string;
+    full_address?: string;
+    place_formatted?: string;
+    feature_type?: string;
+    poi_category?: string | string[];
+    category?: string;
+    mapbox_id?: string;
+    address?: string;
+}
+/**
+ * Mapbox Feature with common properties
+ */
+export type MapboxFeature = Feature<MapboxFeatureProperties>;
+/**
+ * Mapbox FeatureCollection with common properties
+ */
+export type MapboxFeatureCollection = FeatureCollection<MapboxFeatureProperties>;
+//# sourceMappingURL=geojson.d.ts.map

package/dist/esm/schemas/geojson.d.ts.map

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

package/dist/esm/schemas/geojson.js

@@ -0,0 +1,4 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=geojson.js.map

package/dist/esm/schemas/geojson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.js","sourceRoot":"","sources":["../../../src/schemas/geojson.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC"}

package/dist/esm/tools/BaseTool.d.ts

@@ -1,14 +1,17 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ToolAnnotations, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import type { ZodTypeAny } from 'zod';
-export declare abstract class BaseTool<InputSchema extends ZodTypeAny> {
+export declare abstract class BaseTool<InputSchema extends ZodTypeAny, OutputSchema extends ZodTypeAny = ZodTypeAny> {
     abstract readonly name: string;
     abstract readonly description: string;
     abstract readonly annotations: ToolAnnotations;
     readonly inputSchema: InputSchema;
+    readonly outputSchema?: OutputSchema;
     protected server: McpServer | null;
     constructor(params: {
         inputSchema: InputSchema;
+        outputSchema?: OutputSchema;
     });
     /**
      * Installs the tool to the given MCP server.
@@ -17,10 +20,17 @@ export declare abstract class BaseTool<InputSchema extends ZodTypeAny> {
     /**
      * Tool logic to be implemented by subclasses.
      */
-    abstract run(rawInput: unknown, extra?: any): Promise<CallToolResult>;
+    abstract run(rawInput: unknown, extra?: RequestHandlerExtra<any, any>): Promise<CallToolResult>;
     /**
      * Helper method to send logging messages
      */
     protected log(level: 'debug' | 'info' | 'warning' | 'error', data: unknown): void;
+    /**
+     * Validates output data against the output schema with graceful fallback.
+     * If validation fails, logs a warning and returns the raw data.
+     * @param rawData The raw data to validate
+     * @returns The validated data, or raw data if validation fails
+     */
+    protected validateOutput<T>(rawData: unknown): T;
 }
 //# sourceMappingURL=BaseTool.d.ts.map

package/dist/esm/tools/BaseTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGtC,8BAAsB,QAAQ,CAAC,WAAW,SAAS,UAAU;IAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE9B,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAIhD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAc5C;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAErE;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,OAAO,GACZ,IAAI;CAKR"}
+{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGtC,8BAAsB,QAAQ,CAC5B,WAAW,SAAS,UAAU,EAC9B,YAAY,SAAS,UAAU,GAAG,UAAU;IAE5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE9B,MAAM,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAKD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IA+B5C;;OAEG;IACH,QAAQ,CAAC,GAAG,CACV,QAAQ,EAAE,OAAO,EAEjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,OAAO,GACZ,IAAI;IAMP;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC;CAgBjD"}