@haivx/tripmind-maps-mcp 0.3.0

package/README.md

@@ -0,0 +1,226 @@
+# tripmind-maps-mcp
+
+A travel-focused MCP (Model Context Protocol) server wrapping Google Maps API. Built for [TripMind](https://github.com/haivx/tripmind) — an AI-powered travel planning app.
+
+This server provides 6 curated location tools that Claude can call for geocoding, place search, directions, and more. It works with Claude Code, Claude Desktop, and any MCP-compatible client.
+
+## Why Custom Instead of Existing Packages?
+
+There are generic Google Maps MCP servers available (like `@cablate/mcp-google-map` with 17 tools). This custom server is purpose-built for travel planning:
+
+- **Lean tool set** — 6 tools instead of 17, saving LLM context tokens
+- **Built-in caching** — geocode results cached 30 days, reducing API costs
+- **Rate limiting** — per-key throttling prevents credit burn
+- **Travel-optimized** — tool descriptions tuned for trip planning queries
+- **Cost-aware** — field masks on all Places API calls, Routes API over legacy
+
+## Tools
+
+| Tool | Description | Google API | Cache TTL |
+|------|-------------|------------|-----------|
+| `maps_geocode` | Address ↔ coordinates conversion | Geocoding | 30 days |
+| `maps_search_places` | Text search & nearby discovery | Places (New) | 24 hours |
+| `maps_place_details` | Rich info: hours, reviews, photos | Place Details | 7 days |
+| `maps_directions` | Route with time, distance, steps | Routes API | 1 hour |
+| `maps_distance_matrix` | Multi-point distance/time grid | Distance Matrix | 1 hour |
+| `maps_timezone` | Timezone by coordinates | Timezone | 90 days |
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 20+ 
+- Google Maps API key with these APIs enabled:
+  - Geocoding API
+  - Places API (New)
+  - Routes API
+  - Distance Matrix API
+  - Timezone API
+
+### Installation
+
+**Via npm (recommended):**
+
+```bash
+npm install -g @haivx/tripmind-maps-mcp
+# or use directly with npx (no install needed)
+```
+
+**From source:**
+
+```bash
+git clone https://github.com/haivx/tripmind-maps-mcp.git
+cd tripmind-maps-mcp
+npm install
+cp .env.example .env
+# Edit .env and add your GOOGLE_MAPS_API_KEY
+npm run build
+```
+
+### Use with Claude Code
+
+```bash
+claude mcp add tripmind-maps -- npx -y @haivx/tripmind-maps-mcp
+```
+
+Or manually add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "tripmind-maps": {
+      "command": "npx",
+      "args": ["-y", "@haivx/tripmind-maps-mcp"],
+      "env": {
+        "GOOGLE_MAPS_API_KEY": "${env:GOOGLE_MAPS_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+### Use with Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tripmind-maps": {
+      "command": "node",
+      "args": ["/absolute/path/to/tripmind-maps-mcp/build/index.js"],
+      "env": {
+        "GOOGLE_MAPS_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### HTTP Mode (Remote Deployment)
+
+```bash
+npm run start:http
+# Server runs on http://localhost:3000/mcp
+```
+
+Connect from any MCP client:
+
+```json
+{
+  "tripmind-maps": {
+    "transport": "streamableHttp",
+    "url": "http://localhost:3000/mcp"
+  }
+}
+```
+
+## Development
+
+```bash
+npm run dev            # Watch mode
+npm run test           # Run tests
+npm run typecheck      # Type check
+npm run inspect        # MCP Inspector UI
+npm run lint           # ESLint
+```
+
+### Adding a New Tool
+
+Use the Claude Code command: `/new-tool`
+
+Or follow these steps:
+
+1. Create `src/tools/<name>.ts` with Zod schema + handler
+2. Register in `src/index.ts` via `server.registerTool()`
+3. Add tests to `tests/tools.test.ts`
+4. Update this README's tool table
+5. Run `npm run typecheck && npm run test`
+
+### Testing with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector node build/index.js
+```
+
+This opens a web UI where you can call each tool with test inputs and see responses.
+
+## Cost Estimation
+
+For personal/MVP usage (< 1,000 calls/month per API), all usage falls within Google's free tiers:
+
+| API | Free Tier | Price After |
+|-----|-----------|-------------|
+| Geocoding | 10,000/month | $5/1,000 |
+| Places Text Search | 10,000/month | $32/1,000 |
+| Place Details (Basic) | 10,000/month | $0 (basic fields) |
+| Routes (Basic) | 10,000/month | $5/1,000 |
+| Distance Matrix | 10,000/month | $5/1,000 elements |
+| Timezone | 10,000/month | $5/1,000 |
+
+**Estimated monthly cost for TripMind MVP: $0**
+
+## Project Structure
+
+```
+tripmind-maps-mcp/
+├── .claude/                  # Claude Code workflow
+│   ├── settings.json         # Hooks, permissions
+│   ├── commands/             # Slash commands (/new-tool, /review, /ship, /debug)
+│   ├── agents/               # Subagent definitions (code-reviewer)
+│   ├── skills/               # Domain knowledge (mcp-tool-dev)
+│   ├── rules/                # Behavior rules (behaviors, content-safety)
+│   └── memory/               # Session continuity (today.md)
+├── docs/
+│   └── IMPLEMENTATION_PLAN.md
+├── src/
+│   ├── index.ts
+│   ├── tools/
+│   ├── utils/
+│   └── types.ts
+├── tests/
+├── CLAUDE.md                 # Project context for Claude Code
+├── README.md
+├── package.json
+├── tsconfig.json
+├── .env.example
+└── .gitignore
+```
+
+## Claude Code Workflow
+
+This project includes a complete Claude Code workflow:
+
+| Component | Purpose |
+|-----------|---------|
+| `CLAUDE.md` | Project context, tech stack, commands, standards |
+| `.claude/rules/behaviors.md` | Development behavior rules (plan first, verify, cost awareness) |
+| `.claude/rules/content-safety.md` | Travel data accuracy rules (never fabricate locations) |
+| `.claude/commands/new-tool.md` | Step-by-step guide for adding MCP tools |
+| `.claude/commands/review.md` | Code review checklist with severity levels |
+| `.claude/commands/ship.md` | Pre-publish verification checklist |
+| `.claude/commands/debug.md` | 5-phase systematic debugging guide |
+| `.claude/agents/code-reviewer.md` | Sonnet-powered code review subagent |
+| `.claude/skills/mcp-tool-dev/` | MCP SDK patterns and best practices |
+| `.claude/hooks` | Auto typecheck on .ts writes, block .env writes, session reminders |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GOOGLE_MAPS_API_KEY` | Yes | Google Maps Platform API key |
+| `PORT` | No | HTTP server port (default: 3000) |
+| `CACHE_ENABLED` | No | Enable/disable caching (default: true) |
+| `RATE_LIMIT_RPM` | No | Requests per minute limit (default: 100) |
+| `LOG_LEVEL` | No | debug, info, warn, error (default: info) |
+
+## Related
+
+- [TripMind](https://github.com/haivx/tripmind) — The parent AI travel planning app
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) — Official SDK
+- [MCP Inspector](https://github.com/modelcontextprotocol/inspector) — Testing tool
+- [Google Maps Services JS](https://github.com/googlemaps/google-maps-services-js) — Google Maps client
+
+## License
+
+MIT

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/build/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { toolName as geocodeName, toolConfig as geocodeConfig, handler as geocodeHandler } from "./tools/geocode.js";
+import { toolName as searchPlacesName, toolConfig as searchPlacesConfig, handler as searchPlacesHandler } from "./tools/search-places.js";
+import { toolName as placeDetailsName, toolConfig as placeDetailsConfig, handler as placeDetailsHandler } from "./tools/place-details.js";
+import { toolName as directionsName, toolConfig as directionsConfig, handler as directionsHandler } from "./tools/directions.js";
+import { toolName as distanceMatrixName, toolConfig as distanceMatrixConfig, handler as distanceMatrixHandler } from "./tools/distance-matrix.js";
+import { toolName as timezoneName, toolConfig as timezoneConfig, handler as timezoneHandler } from "./tools/timezone.js";
+import { assertRateLimit } from "./utils/rate-limiter.js";
+/** Create and register all tools on a new McpServer instance. */
+function createMcpServer() {
+    const server = new McpServer({ name: "tripmind-maps", version: "0.1.0" });
+    server.registerTool(geocodeName, geocodeConfig, geocodeHandler);
+    server.registerTool(searchPlacesName, searchPlacesConfig, searchPlacesHandler);
+    server.registerTool(placeDetailsName, placeDetailsConfig, placeDetailsHandler);
+    server.registerTool(directionsName, directionsConfig, directionsHandler);
+    server.registerTool(distanceMatrixName, distanceMatrixConfig, distanceMatrixHandler);
+    server.registerTool(timezoneName, timezoneConfig, timezoneHandler);
+    return server;
+}
+const useHttp = process.argv.includes("--http") || process.env["HTTP_MODE"] === "true";
+if (useHttp) {
+    // ---------------------------------------------------------------------------
+    // HTTP transport (production / remote clients)
+    // ---------------------------------------------------------------------------
+    const port = parseInt(process.env["PORT"] ?? "3000", 10);
+    const app = express();
+    app.use(express.json());
+    // CORS — allow all origins for local development
+    app.use((_req, res, next) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+        next();
+    });
+    app.options("/mcp", (_req, res) => {
+        res.sendStatus(204);
+    });
+    // Rate limit per IP before reaching MCP handler
+    app.use("/mcp", (req, res, next) => {
+        const ip = req.ip ?? req.socket.remoteAddress ?? "unknown";
+        try {
+            assertRateLimit(ip);
+            next();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Rate limit exceeded";
+            res.status(429).json({ error: message });
+        }
+    });
+    // Stateless: create a fresh server + transport per request
+    app.post("/mcp", async (req, res) => {
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+        const server = createMcpServer();
+        await server.connect(transport);
+        try {
+            await transport.handleRequest(req, res, req.body);
+        }
+        finally {
+            await server.close();
+        }
+    });
+    app.listen(port, () => {
+        console.error(`[tripmind-maps] HTTP server on port ${port}`);
+    });
+}
+else {
+    // ---------------------------------------------------------------------------
+    // Stdio transport (Claude Code / Desktop — default)
+    // ---------------------------------------------------------------------------
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[tripmind-maps] MCP server started");
+}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/tools/directions.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export declare const toolName = "maps_directions";
+export declare const inputSchema: {
+    origin: z.ZodString;
+    destination: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<["DRIVE", "WALK", "TRANSIT", "BICYCLE"]>>;
+    departure_time: z.ZodOptional<z.ZodString>;
+};
+export declare const toolConfig: {
+    title: string;
+    description: string;
+    inputSchema: {
+        origin: z.ZodString;
+        destination: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<["DRIVE", "WALK", "TRANSIT", "BICYCLE"]>>;
+        departure_time: z.ZodOptional<z.ZodString>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+type DirectionsArgs = {
+    origin: string;
+    destination: string;
+    mode?: "DRIVE" | "WALK" | "TRANSIT" | "BICYCLE";
+    departure_time?: string;
+};
+export declare function handler(args: DirectionsArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};
+//# sourceMappingURL=directions.d.ts.map

package/build/tools/directions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directions.d.ts","sourceRoot":"","sources":["../../src/tools/directions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAE1C,eAAO,MAAM,WAAW;;;;;CAWvB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;CAUtB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc;;;;;;;;;;;;GA2BjD"}

package/build/tools/directions.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { cache } from "../utils/cache.js";
+import { computeRoute } from "../utils/google-client.js";
+const TTL_MS = 60 * 60 * 1000; // 1 hour
+export const toolName = "maps_directions";
+export const inputSchema = {
+    origin: z.string().describe("Starting point — address, landmark name, or 'place_id:ChIJ...'"),
+    destination: z.string().describe("End point — address, landmark name, or 'place_id:ChIJ...'"),
+    mode: z
+        .enum(["DRIVE", "WALK", "TRANSIT", "BICYCLE"])
+        .optional()
+        .describe("Travel mode. Default: TRANSIT (best for city travel)"),
+    departure_time: z
+        .string()
+        .optional()
+        .describe("ISO 8601 datetime for traffic-aware routing, e.g. '2026-04-10T09:00:00+09:00'"),
+};
+export const toolConfig = {
+    title: "Get Directions",
+    description: "Calculate a route between two places with travel time, distance, and step-by-step directions. Supports driving, walking, transit, and cycling. Use this when the user asks 'how to get from A to B' or when planning daily itinerary routes.",
+    inputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+};
+export async function handler(args) {
+    try {
+        const mode = args.mode ?? "TRANSIT";
+        const cacheKey = `directions:${args.origin.toLowerCase().trim()}:${args.destination.toLowerCase().trim()}:${mode}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: JSON.stringify(cached) }] };
+        }
+        const result = await computeRoute({
+            origin: args.origin,
+            destination: args.destination,
+            mode,
+            departure_time: args.departure_time,
+        });
+        cache.set(cacheKey, result, TTL_MS);
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[maps_directions] error: ${message}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=directions.js.map

package/build/tools/directions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directions.js","sourceRoot":"","sources":["../../src/tools/directions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAExC,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC7F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC7F,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SAC7C,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;CAC7F,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,8OAA8O;IAChP,WAAW;IACX,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC;AASF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAoB;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;QACpC,MAAM,QAAQ,GAAG,cAAc,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAEnH,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAmB,QAAQ,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI;YACJ,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;QAEH,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/tools/distance-matrix.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare const toolName = "maps_distance_matrix";
+export declare const inputSchema: {
+    origins: z.ZodArray<z.ZodString, "many">;
+    destinations: z.ZodArray<z.ZodString, "many">;
+    mode: z.ZodOptional<z.ZodEnum<["DRIVE", "WALK", "TRANSIT", "BICYCLE"]>>;
+};
+export declare const toolConfig: {
+    title: string;
+    description: string;
+    inputSchema: {
+        origins: z.ZodArray<z.ZodString, "many">;
+        destinations: z.ZodArray<z.ZodString, "many">;
+        mode: z.ZodOptional<z.ZodEnum<["DRIVE", "WALK", "TRANSIT", "BICYCLE"]>>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+type DistanceMatrixArgs = {
+    origins: string[];
+    destinations: string[];
+    mode?: "DRIVE" | "WALK" | "TRANSIT" | "BICYCLE";
+};
+export declare function handler(args: DistanceMatrixArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};
+//# sourceMappingURL=distance-matrix.d.ts.map

package/build/tools/distance-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance-matrix.d.ts","sourceRoot":"","sources":["../../src/tools/distance-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAE/C,eAAO,MAAM,WAAW;;;;CAevB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAUtB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACjD,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;;;GA4BrD"}

package/build/tools/distance-matrix.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { cache } from "../utils/cache.js";
+import { distanceMatrix as googleDistanceMatrix } from "../utils/google-client.js";
+const TTL_MS = 60 * 60 * 1000; // 1 hour
+export const toolName = "maps_distance_matrix";
+export const inputSchema = {
+    origins: z
+        .array(z.string())
+        .min(1)
+        .max(10)
+        .describe("List of starting points (addresses or place_ids)"),
+    destinations: z
+        .array(z.string())
+        .min(1)
+        .max(10)
+        .describe("List of end points (addresses or place_ids)"),
+    mode: z
+        .enum(["DRIVE", "WALK", "TRANSIT", "BICYCLE"])
+        .optional()
+        .describe("Travel mode. Default: TRANSIT"),
+};
+export const toolConfig = {
+    title: "Distance Matrix",
+    description: "Calculate travel distances and times between multiple origins and destinations at once. Returns a matrix of all pairs. Use this to optimize itinerary order — find which places are closest to each other for efficient day planning.",
+    inputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+};
+export async function handler(args) {
+    try {
+        const mode = args.mode ?? "TRANSIT";
+        const originsKey = args.origins.map((o) => o.toLowerCase().trim()).join("|");
+        const destsKey = args.destinations.map((d) => d.toLowerCase().trim()).join("|");
+        const cacheKey = `distance-matrix:${originsKey}:${destsKey}:${mode}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: JSON.stringify(cached) }] };
+        }
+        const result = await googleDistanceMatrix({
+            origins: args.origins,
+            destinations: args.destinations,
+            mode,
+        });
+        cache.set(cacheKey, result, TTL_MS);
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[maps_distance_matrix] error: ${message}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=distance-matrix.js.map

package/build/tools/distance-matrix.js.map

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

package/build/tools/geocode.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const toolName = "maps_geocode";
+/** Input schema shape for the maps_geocode tool. */
+export declare const inputSchema: {
+    address: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    language: z.ZodOptional<z.ZodString>;
+};
+/** Tool registration config for McpServer.registerTool(). */
+export declare const toolConfig: {
+    title: string;
+    description: string;
+    inputSchema: {
+        address: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+        language: z.ZodOptional<z.ZodString>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+type GeocodeArgs = {
+    address?: string;
+    latitude?: number;
+    longitude?: number;
+    language?: string;
+};
+/**
+ * Handler for the maps_geocode tool.
+ * Validates that either `address` or both `latitude`+`longitude` are provided,
+ * checks the cache, calls Google Geocoding API on miss, and caches the result.
+ */
+export declare function handler(args: GeocodeArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=geocode.d.ts.map

package/build/tools/geocode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocode.d.ts","sourceRoot":"","sources":["../../src/tools/geocode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AAEvC,oDAAoD;AACpD,eAAO,MAAM,WAAW;;;;;CAmBvB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;CAUtB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW;;;;;;;;;;;;GAwD9C"}