Reapply "Merge pull request #33 from mapbox/output_schemas"

This reverts commit 4853cac.

Author: mattpodwysocki

cspell.config.json

@@ -0,0 +1,16 @@
+{
+ "version": "0.2",
+ "language": "en",
+ "words": [
+ "bbox",
+ "denoise",
+ "isochrone",
+ "mapbox",
+ "mmss",
+ "tilequery"
+ ],
+ "ignorePaths": [
+ "node_modules",
+ "dist"
+ ]
+}

package-lock.json

@@ -10,18 +10,18 @@
  "mapbox-mcp-devkit": "dist/esm/index.js"
  },
  "scripts": {
- "lint": "eslint \"./src/**/*.{ts,tsx}\" \"./test/**/*.{ts,tsx}\"",
- "lint:fix": "eslint \"./src/**/*.{ts,tsx}\" \"./test/**/*.{ts,tsx}\" --fix",
- "fix-lint": "npm run lint:fix && npm run format:fix",
+ "build": "npm run prepare && tshy && npm run generate-version && node scripts/add-shebang.cjs",
  "format": "prettier --check \"./src/**/*.{ts,tsx,js,json,md}\" \"./test/**/*.{ts,tsx,js,json,md}\"",
  "format:fix": "prettier --write \"./src/**/*.{ts,tsx,js,json,md}\" \"./test/**/*.{ts,tsx,js,json,md}\"",
- "prepare": "husky && node .husky/setup-hooks.js",
- "test": "vitest",
- "build": "npm run prepare && npm run sync-manifest && tshy && npm run generate-version && node scripts/build-helpers.cjs copy-json && node scripts/add-shebang.cjs",
  "generate-version": "node scripts/build-helpers.cjs generate-version",
+ "inspect:build": "npm run build && npx @modelcontextprotocol/inspector -e MAPBOX_ACCESS_TOKEN=\"$MAPBOX_ACCESS_TOKEN\" node dist/esm/index.js",
+ "inspect:dev": "npx @modelcontextprotocol/inspector -e MAPBOX_ACCESS_TOKEN=\"$MAPBOX_ACCESS_TOKEN\" npx -y tsx src/index.ts",
+ "lint": "eslint \"./src/**/*.{ts,tsx}\" \"./test/**/*.{ts,tsx}\"",
+ "lint:fix": "eslint \"./src/**/*.{ts,tsx}\" \"./test/**/*.{ts,tsx}\" --fix",
+ "prepare": "husky && node .husky/setup-hooks.js",
+ "spellcheck": "cspell \"*.md\" \"src/**/*.ts\" \"test/**/*.ts\"",
  "sync-manifest": "node scripts/sync-manifest-version.cjs",
- "dev": "tsc -p tsconfig.json --watch",
- "dev:inspect": "npx @modelcontextprotocol/inspector -e MAPBOX_ACCESS_TOKEN=\"$MAPBOX_ACCESS_PRIVATE_TOKEN\" npx -y tsx src/index.ts"
+ "test": "vitest"
  },
  "lint-staged": {
  "*.{js,jsx,ts,tsx}": "eslint --fix",
@@ -53,6 +53,7 @@
  "@typescript-eslint/eslint-plugin": "^8.0.0",
  "@typescript-eslint/parser": "^8.0.0",
  "@vitest/coverage-istanbul": "^3.2.4",
+ "cspell": "^9.2.1",
  "eslint": "^9.0.0",
  "eslint-config-prettier": "^10.1.8",
  "eslint-plugin-n": "^17.21.3",

package.json

@@ -1,3 +1,6 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { parseToolConfigFromArgs, filterTools } from './config/toolConfig.js';

src/index.ts

@@ -0,0 +1,223 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+
+import { z } from 'zod';
+
+// Basic types
+const ColorSchema = z
+ .string()
+ .describe('Color as hex, rgb, rgba, hsl, or hsla');
+const CoordinatesSchema = z.tuple([z.number(), z.number()]);
+
+// Transition schema
+const TransitionSchema = z.object({
+ duration: z.number().optional(),
+ delay: z.number().optional()
+});
+
+// Light schema
+const LightSchema = z.object({
+ anchor: z.enum(['map', 'viewport']).optional(),
+ position: z.tuple([z.number(), z.number(), z.number()]).optional(),
+ color: ColorSchema.optional(),
+ intensity: z.number().optional()
+});
+
+// Lights (3D) schema
+const LightsSchema = z.array(
+ z.object({
+ id: z.string(),
+ type: z.enum(['ambient', 'directional']),
+ properties: z.record(z.any()).optional()
+ })
+);
+
+// Terrain schema
+const TerrainSchema = z.object({
+ source: z.string(),
+ exaggeration: z.number().optional()
+});
+
+// Source schemas
+const VectorSourceSchema = z.object({
+ type: z.literal('vector'),
+ url: z.string().optional(),
+ tiles: z.array(z.string()).optional(),
+ bounds: z.tuple([z.number(), z.number(), z.number(), z.number()]).optional(),
+ scheme: z.enum(['xyz', 'tms']).optional(),
+ minzoom: z.number().min(0).max(22).optional(),
+ maxzoom: z.number().min(0).max(22).optional(),
+ attribution: z.string().optional(),
+ promoteId: z.union([z.string(), z.record(z.string())]).optional(),
+ volatile: z.boolean().optional()
+});
+
+const RasterSourceSchema = z.object({
+ type: z.literal('raster'),
+ url: z.string().optional(),
+ tiles: z.array(z.string()).optional(),
+ bounds: z.tuple([z.number(), z.number(), z.number(), z.number()]).optional(),
+ minzoom: z.number().min(0).max(22).optional(),
+ maxzoom: z.number().min(0).max(22).optional(),
+ tileSize: z.number().optional(),
+ scheme: z.enum(['xyz', 'tms']).optional(),
+ attribution: z.string().optional(),
+ volatile: z.boolean().optional()
+});
+
+const RasterDemSourceSchema = z.object({
+ type: z.literal('raster-dem'),
+ url: z.string().optional(),
+ tiles: z.array(z.string()).optional(),
+ bounds: z.tuple([z.number(), z.number(), z.number(), z.number()]).optional(),
+ minzoom: z.number().min(0).max(22).optional(),
+ maxzoom: z.number().min(0).max(22).optional(),
+ tileSize: z.number().optional(),
+ attribution: z.string().optional(),
+ encoding: z.enum(['terrarium', 'mapbox']).optional(),
+ volatile: z.boolean().optional()
+});
+
+const GeoJSONSourceSchema = z.object({
+ type: z.literal('geojson'),
+ data: z.union([z.string(), z.any()]), // URL or inline GeoJSON
+ maxzoom: z.number().min(0).max(24).optional(),
+ attribution: z.string().optional(),
+ buffer: z.number().min(0).max(512).optional(),
+ tolerance: z.number().optional(),
+ cluster: z.boolean().optional(),
+ clusterRadius: z.number().optional(),
+ clusterMaxZoom: z.number().optional(),
+ clusterProperties: z.record(z.any()).optional(),
+ lineMetrics: z.boolean().optional(),
+ generateId: z.boolean().optional(),
+ promoteId: z.union([z.string(), z.record(z.string())]).optional()
+});
+
+const ImageSourceSchema = z.object({
+ type: z.literal('image'),
+ url: z.string(),
+ coordinates: z.tuple([
+ CoordinatesSchema,
+ CoordinatesSchema,
+ CoordinatesSchema,
+ CoordinatesSchema
+ ])
+});
+
+const VideoSourceSchema = z.object({
+ type: z.literal('video'),
+ urls: z.array(z.string()),
+ coordinates: z.tuple([
+ CoordinatesSchema,
+ CoordinatesSchema,
+ CoordinatesSchema,
+ CoordinatesSchema
+ ])
+});
+
+const SourceSchema = z.union([
+ VectorSourceSchema,
+ RasterSourceSchema,
+ RasterDemSourceSchema,
+ GeoJSONSourceSchema,
+ ImageSourceSchema,
+ VideoSourceSchema
+]);
+
+// Layer schema (simplified - full schema would be very extensive)
+const LayerSchema = z.object({
+ id: z.string().describe('Unique layer name'),
+ type: z.enum([
+ 'fill',
+ 'line',
+ 'symbol',
+ 'circle',
+ 'heatmap',
+ 'fill-extrusion',
+ 'raster',
+ 'hillshade',
+ 'background',
+ 'sky',
+ 'slot',
+ 'clip',
+ 'model',
+ 'raster-particle',
+ 'building'
+ ]),
+ source: z
+ .string()
+ .optional()
+ .describe('Source name (not required for background/sky/slot)'),
+ 'source-layer': z
+ .string()
+ .optional()
+ .describe('Layer from vector tile source'),
+ minzoom: z.number().min(0).max(24).optional(),
+ maxzoom: z.number().min(0).max(24).optional(),
+ filter: z.any().optional().describe('Expression for filtering features'),
+ layout: z.record(z.any()).optional(),
+ paint: z.record(z.any()).optional(),
+ metadata: z.record(z.any()).optional(),
+ slot: z.string().optional().describe('Slot this layer is assigned to')
+});
+
+// Style import schema
+const StyleImportSchema = z.object({
+ id: z.string(),
+ url: z.string(),
+ config: z.record(z.any()).optional()
+});
+
+// Base Style properties (shared between input and output)
+export const BaseStylePropertiesSchema = z.object({
+ // Required Style Spec properties
+ version: z
+ .literal(8)
+ .describe('Style specification version number. Must be 8'),
+ sources: z.record(SourceSchema).describe('Data source specifications'),
+ layers: z.array(LayerSchema).describe('Layers in draw order'),
+
+ // Optional Style Spec properties
+ metadata: z
+ .record(z.any())
+ .optional()
+ .describe('Arbitrary properties for tracking'),
+ center: CoordinatesSchema.optional().describe(
+ 'Default map center [longitude, latitude]'
+ ),
+ zoom: z.number().optional().describe('Default zoom level'),
+ bearing: z.number().optional().describe('Default bearing in degrees'),
+ pitch: z.number().optional().describe('Default pitch in degrees'),
+ sprite: z
+ .string()
+ .optional()
+ .describe('Base URL for sprite image and metadata'),
+ glyphs: z.string().optional().describe('URL template for glyph sets'),
+ light: LightSchema.optional()
+ .nullable()
+ .describe('Global light source (deprecated, use lights)'),
+ lights: LightsSchema.optional()
+ .nullable()
+ .describe('Array of 3D light sources'),
+ terrain: TerrainSchema.optional()
+ .nullable()
+ .describe('Global terrain elevation'),
+ fog: z.record(z.any()).optional().nullable().describe('Fog properties'),
+ projection: z
+ .record(z.any())
+ .optional()
+ .nullable()
+ .describe('Map projection'),
+ transition: TransitionSchema.optional()
+ .nullable()
+ .describe('Default transition timing'),
+ imports: z
+ .array(StyleImportSchema)
+ .optional()
+ .nullable()
+ .describe('Imported styles')
+});
+
+export type MapboxSource = z.infer<typeof SourceSchema>;
+export type MapboxLayer = z.infer<typeof LayerSchema>;