@cablate/mcp-google-map 0.0.4 → 0.0.6

package/README.md

@@ -1,113 +1,353 @@
-# MCP Google Map Server
-
-A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with LLM processing capabilities.
-
-## Features
-
-### Google Maps Features
-
-- **Location Search**
-
-  - Search for places near a specific location with customizable radius and filters
-  - Get detailed place information including ratings, opening hours, and contact details
-
-- **Geocoding Services**
-
-  - Convert addresses to coordinates (geocoding)
-  - Convert coordinates to addresses (reverse geocoding)
-
-- **Distance & Directions**
-
-  - Calculate distances and travel times between multiple origins and destinations
-  - Get detailed directions between two points with step-by-step instructions
-  - Support for different travel modes (driving, walking, bicycling, transit)
-
-- **Elevation Data**
-  - Retrieve elevation data for specific locations
-
-## Installation
-
-### Via NPM
-
-```bash
-npm install -g @cablate/mcp-google-map
-```
-
-## Usage
-
-### Command Line
-
-```bash
-mcp-google-map
-```
-
-### Integration with [Dive Desktop](https://github.com/OpenAgentPlatform/Dive)
-
-1. Click "+ Add MCP Server" in Dive Desktop
-2. Copy and paste the following configuration:
-
-```json
-{
-  "mcpServers": {
-    "google-map": {
-      "command": "npx",
-      "args": ["-y", "@cablate/mcp-google-map"],
-      "env": {
-        "GOOGLE_MAPS_API_KEY": "your_api_key"
-      },
-      "enabled": true
-    }
-  }
-}
-```
-
-3. Click "Save" to complete the installation
-
-## Available Tools
-
-The server provides the following tools:
-
-1. **search_nearby** - Search for places near a specific location
-2. **get_place_details** - Get detailed information about a specific place
-3. **maps_geocode** - Convert an address to coordinates
-4. **maps_reverse_geocode** - Convert coordinates to an address
-5. **maps_distance_matrix** - Calculate distances and times between multiple origins and destinations
-6. **maps_directions** - Get directions between two points
-7. **maps_elevation** - Get elevation data for specific locations
-
-## Google Maps API Setup
-
-To use this service, you need to:
-
-1. Create a project in [Google Cloud Console](https://console.cloud.google.com/)
-2. Enable Google Maps API services
-3. Obtain an API key
-4. Set the `GOOGLE_MAPS_API_KEY` environment variable
-
-## Tech Stack
-
-- TypeScript
-- Node.js
-- Google Maps Services JS
-- Model Context Protocol SDK
-
-## License
-
-MIT
-
-## Contributing
-
-Community participation and contributions are welcome! Here's how you can contribute:
-
-- ⭐️ Star the project if you find it helpful
-- 🐛 Submit Issues: Report bugs or provide suggestions
-- 🔧 Create Pull Requests: Submit code improvements
-
-## Contact
-
-If you have any questions or suggestions, feel free to reach out:
-
-- 📧 Email: [reahtuoo310109@gmail.com](mailto:reahtuoo310109@gmail.com)
-- 📧 GitHub: [CabLate](https://github.com/cablate/)
-- 🤝 Collaboration: Welcome to discuss project cooperation
-- 📚 Technical Guidance: Sincere welcome for suggestions and guidance
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cablate-mcp-google-map-badge.png)](https://mseep.ai/app/cablate-mcp-google-map)
+
+<a href="https://glama.ai/mcp/servers/@cablate/mcp-google-map">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@cablate/mcp-google-map/badge" alt="Google Map Server MCP server" />
+</a>
+
+# MCP Google Map Server
+
+A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with streamable HTTP transport support and LLM processing capabilities.
+
+## Features
+
+### 🗺️ Google Maps Integration
+
+- **Location Search**
+  - Search for places near a specific location with customizable radius and filters
+  - Get detailed place information including ratings, opening hours, and contact details
+
+- **Geocoding Services**
+  - Convert addresses to coordinates (geocoding)
+  - Convert coordinates to addresses (reverse geocoding)
+
+- **Distance & Directions**
+  - Calculate distances and travel times between multiple origins and destinations
+  - Get detailed turn-by-turn directions between two points
+  - Support for different travel modes (driving, walking, bicycling, transit)
+
+- **Elevation Data**
+  - Retrieve elevation data for specific locations
+
+### 🚀 Advanced Features
+
+- **Streamable HTTP Transport**: Latest MCP protocol with real-time streaming capabilities
+- **Session Management**: Stateful sessions with UUID-based identification
+- **Multiple Connection Support**: Handle multiple concurrent client connections
+- **Echo Service**: Built-in testing tool for MCP server functionality
+
+## Installation
+
+### Via NPM
+
+```bash
+npm install -g @cablate/mcp-google-map
+```
+
+### Via NPX (Recommended)
+
+```bash
+npx @cablate/mcp-google-map
+```
+
+## Quick Start
+
+### 1. Get Google Maps API Key
+
+1. Create a project in [Google Cloud Console](https://console.cloud.google.com/)
+2. Enable the following APIs:
+   - Maps JavaScript API
+   - Places API
+   - Geocoding API
+   - Distance Matrix API
+   - Directions API
+   - Elevation API
+3. Create an API key
+4. Set up your environment:
+
+```bash
+export GOOGLE_MAPS_API_KEY="your_api_key_here"
+export MCP_SERVER_PORT=3000
+```
+
+### 2. Run the Server
+
+```bash
+# Using NPX (recommended)
+npx @cablate/mcp-google-map
+
+# Or if installed globally
+mcp-google-map
+
+# With custom port and API key
+mcp-google-map --port 3001 --apikey "your_api_key_here"
+
+# Using short options
+mcp-google-map -p 3001 -k "your_api_key_here"
+```
+
+### 3. Server Endpoints
+
+- **Main MCP Endpoint**: `http://localhost:3000/mcp`
+- **Available Tools**: 8 tools including Google Maps services and echo
+
+## Configuration
+
+### Command Line Options
+
+The server supports the following command-line options:
+
+```bash
+# Show help
+mcp-google-map --help
+
+# Basic usage
+mcp-google-map --port 3000 --apikey "your_api_key"
+
+# Using short options
+mcp-google-map -p 3000 -k "your_api_key"
+```
+
+Available options:
+- `--port, -p`: Port to run the MCP server on (default: 3000)
+- `--apikey, -k`: Google Maps API key (required)
+- `--help, -h`: Show help information
+
+### Environment Variables
+
+Alternatively, create a `.env` file in your working directory:
+
+```env
+# Required
+GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here
+
+# Optional
+MCP_SERVER_PORT=3000
+```
+
+**Note**: Command line options take precedence over environment variables.
+
+## Available Tools
+
+The server provides the following tools:
+
+### Google Maps Tools
+
+1. **search_nearby** - Search for nearby places based on location, with optional filtering by keywords, distance, rating, and operating hours
+2. **get_place_details** - Get detailed information about a specific place including contact details, reviews, ratings, and operating hours
+3. **maps_geocode** - Convert addresses or place names to geographic coordinates (latitude and longitude)
+4. **maps_reverse_geocode** - Convert geographic coordinates to a human-readable address
+5. **maps_distance_matrix** - Calculate travel distances and durations between multiple origins and destinations
+6. **maps_directions** - Get detailed turn-by-turn navigation directions between two locations
+7. **maps_elevation** - Get elevation data (height above sea level) for specific geographic locations
+
+### Utility Tools
+
+8. **echo** - Echo back input messages with optional streaming support for testing MCP server functionality
+
+## Usage Examples
+
+### Search Nearby Places
+
+```json
+{
+  "tool": "search_nearby",
+  "arguments": {
+    "center": {
+      "value": "Taipei 101",
+      "isCoordinates": false
+    },
+    "keyword": "restaurant",
+    "radius": 1000,
+    "openNow": true,
+    "minRating": 4.0
+  }
+}
+```
+
+### Get Directions
+
+```json
+{
+  "tool": "maps_directions",
+  "arguments": {
+    "origin": "Taipei Main Station",
+    "destination": "Taipei 101",
+    "mode": "walking"
+  }
+}
+```
+
+### Geocode Address
+
+```json
+{
+  "tool": "maps_geocode",
+  "arguments": {
+    "address": "Taipei 101, Taiwan"
+  }
+}
+```
+
+## Integration with MCP Clients
+
+### [Dive Desktop](https://github.com/OpenAgentPlatform/Dive)
+
+1. Click "+ Add MCP Server" in Dive Desktop
+2. Copy and paste the following configuration:
+
+```json
+{
+  "mcpServers": {
+    "google-map": {
+      "command": "npx",
+      "args": ["-y", "@cablate/mcp-google-map"],
+      "env": {
+        "GOOGLE_MAPS_API_KEY": "your_api_key",
+        "MCP_SERVER_PORT": "3000"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
+3. Click "Save" to complete the installation
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration:
+
+```json
+{
+  "mcpServers": {
+    "google-map": {
+      "command": "npx",
+      "args": ["@cablate/mcp-google-map"],
+      "env": {
+        "GOOGLE_MAPS_API_KEY": "your_api_key"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/cablate/mcp-google-map.git
+cd mcp-google-map
+
+# Install dependencies
+npm install
+
+# Set up environment variables
+cp .env.example .env
+# Edit .env with your API key
+
+# Build the project
+npm run build
+
+# Start the server
+npm start
+
+# Or run in development mode
+npm run dev
+```
+
+### Project Structure
+
+```
+src/
+├── cli.ts                    # Main CLI entry point
+├── config.ts                 # Server configuration
+├── index.ts                  # Package exports
+├── core/
+│   └── BaseMcpServer.ts     # Base MCP server with streamable HTTP
+└── tools/
+    ├── echo.ts              # Echo service tool
+    └── maps/                # Google Maps tools
+        ├── toolclass.ts     # Google Maps API client
+        ├── searchPlaces.ts  # Maps service layer
+        ├── searchNearby.ts  # Search nearby places
+        ├── placeDetails.ts  # Place details
+        ├── geocode.ts       # Geocoding
+        ├── reverseGeocode.ts # Reverse geocoding
+        ├── distanceMatrix.ts # Distance matrix
+        ├── directions.ts    # Directions
+        └── elevation.ts     # Elevation data
+```
+
+## Tech Stack
+
+- **TypeScript** - Type-safe development
+- **Node.js** - Runtime environment
+- **Google Maps Services JS** - Google Maps API integration
+- **Model Context Protocol SDK** - MCP protocol implementation
+- **Express.js** - HTTP server framework
+- **Zod** - Schema validation
+
+## Security Considerations
+
+- API keys are handled server-side for security
+- DNS rebinding protection available for production
+- Input validation using Zod schemas
+- Error handling and logging
+
+## Troubleshooting
+
+### Common Issues
+
+1. **API Key Issues**
+   ```bash
+   # Check if API key is set
+   echo $GOOGLE_MAPS_API_KEY
+   ```
+
+2. **Port Conflicts**
+   ```bash
+   # Change port in .env file
+   MCP_SERVER_PORT=3001
+   ```
+
+3. **API Quotas**
+   - Check your Google Cloud Console for API usage
+   - Ensure billing is enabled for your project
+
+## License
+
+MIT
+
+## Contributing
+
+Community participation and contributions are welcome! Here's how you can contribute:
+
+- ⭐️ Star the project if you find it helpful
+- 🐛 Submit Issues: Report bugs or provide suggestions
+- 🔧 Create Pull Requests: Submit code improvements
+- 📖 Documentation: Help improve documentation
+
+## Contact
+
+If you have any questions or suggestions, feel free to reach out:
+
+- 📧 Email: [reahtuoo310109@gmail.com](mailto:reahtuoo310109@gmail.com)
+- 💻 GitHub: [CabLate](https://github.com/cablate/)
+- 🤝 Collaboration: Welcome to discuss project cooperation
+- 📚 Technical Guidance: Sincere welcome for suggestions and guidance
+
+## Changelog
+
+### v0.0.5
+- Added streamable HTTP transport support
+- Improved CLI interface with emoji indicators
+- Enhanced error handling and logging
+- Added comprehensive tool descriptions for LLM integration
+- Updated to latest MCP SDK version
+
+### v0.0.4
+- Initial release with basic Google Maps integration
+- Support for location search, geocoding, and directions
+- Compatible with MCP protocol

package/dist/chunk-U2CGP7BJ.js

@@ -0,0 +1 @@
+var n=(r=>(r.DISPLAY="display",r.LLM="llm",r))(n||{}),o={log:(...l)=>{},error:(...l)=>{}};export{n as a,o as b};

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function startServer(port?: number, apiKey?: string): Promise<void>;
+
+export { startServer };

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{b as d}from"./chunk-U2CGP7BJ.js";import{config as Ie}from"dotenv";import{resolve as Re}from"path";import De from"yargs";import{hideBin as Ge}from"yargs/helpers";import{z as T}from"zod";var $="echo",k="Echo back the input message with optional streaming support for testing MCP server functionality",H={message:T.string().describe("The message to echo back"),stream:T.boolean().optional().describe("Whether to stream the response as chunks (default: false)")};async function L({message:o,stream:e=!1}){try{return e?{content:o.split(" ").map((s,n)=>({type:"text",text:n===0?s:` ${s}`}))}:{content:[{type:"text",text:`Echo: ${o}`}]}}catch(r){return{isError:!0,content:[{type:"text",text:`Echo error: ${r instanceof Error?r.message:JSON.stringify(r)}`}]}}}var f={NAME:$,DESCRIPTION:k,SCHEMA:H,ACTION:L};import{z as g}from"zod";import{Client as z,Language as K}from"@googlemaps/google-maps-services-js";import J from"dotenv";J.config();var N=class{constructor(){this.defaultLanguage=K.zh_TW;if(this.client=new z({}),!process.env.GOOGLE_MAPS_API_KEY)throw new Error("Google Maps API Key is required")}async searchNearbyPlaces(e){let r={location:e.location,radius:e.radius||1e3,keyword:e.keyword,opennow:e.openNow,language:this.defaultLanguage,key:process.env.GOOGLE_MAPS_API_KEY||""};try{let s=(await this.client.placesNearby({params:r})).data.results;return e.minRating&&(s=s.filter(n=>(n.rating||0)>=(e.minRating||0))),s}catch(t){throw console.error("Error in searchNearbyPlaces:",t),new Error("\u641C\u5C0B\u9644\u8FD1\u5730\u9EDE\u6642\u767C\u751F\u932F\u8AA4")}}async getPlaceDetails(e){try{return(await this.client.placeDetails({params:{place_id:e,fields:["name","rating","formatted_address","opening_hours","reviews","geometry","formatted_phone_number","website","price_level","photos"],language:this.defaultLanguage,key:process.env.GOOGLE_MAPS_API_KEY||""}})).data.result}catch(r){throw console.error("Error in getPlaceDetails:",r),new Error("\u7372\u53D6\u5730\u9EDE\u8A73\u7D30\u8CC7\u8A0A\u6642\u767C\u751F\u932F\u8AA4")}}async geocodeAddress(e){try{let r=await this.client.geocode({params:{address:e,key:process.env.GOOGLE_MAPS_API_KEY||"",language:this.defaultLanguage}});if(r.data.results.length===0)throw new Error("\u627E\u4E0D\u5230\u8A72\u5730\u5740\u7684\u4F4D\u7F6E");let t=r.data.results[0],s=t.geometry.location;return{lat:s.lat,lng:s.lng,formatted_address:t.formatted_address,place_id:t.place_id}}catch(r){throw console.error("Error in geocodeAddress:",r),new Error("\u5730\u5740\u8F49\u63DB\u5EA7\u6A19\u6642\u767C\u751F\u932F\u8AA4")}}parseCoordinates(e){let r=e.split(",").map(t=>parseFloat(t.trim()));if(r.length!==2||isNaN(r[0])||isNaN(r[1]))throw new Error("\u7121\u6548\u7684\u5EA7\u6A19\u683C\u5F0F\uFF0C\u8ACB\u4F7F\u7528\u300C\u7DEF\u5EA6,\u7D93\u5EA6\u300D\u683C\u5F0F");return{lat:r[0],lng:r[1]}}async getLocation(e){return e.isCoordinates?this.parseCoordinates(e.value):this.geocodeAddress(e.value)}async geocode(e){try{let r=await this.geocodeAddress(e);return{location:{lat:r.lat,lng:r.lng},formatted_address:r.formatted_address||"",place_id:r.place_id||""}}catch(r){throw console.error("Error in geocode:",r),new Error("\u5730\u5740\u8F49\u63DB\u5EA7\u6A19\u6642\u767C\u751F\u932F\u8AA4")}}async reverseGeocode(e,r){try{let t=await this.client.reverseGeocode({params:{latlng:{lat:e,lng:r},language:this.defaultLanguage,key:process.env.GOOGLE_MAPS_API_KEY||""}});if(t.data.results.length===0)throw new Error("\u627E\u4E0D\u5230\u8A72\u5EA7\u6A19\u7684\u5730\u5740");let s=t.data.results[0];return{formatted_address:s.formatted_address,place_id:s.place_id,address_components:s.address_components}}catch(t){throw console.error("Error in reverseGeocode:",t),new Error("\u5EA7\u6A19\u8F49\u63DB\u5730\u5740\u6642\u767C\u751F\u932F\u8AA4")}}async calculateDistanceMatrix(e,r,t="driving"){try{let n=(await this.client.distancematrix({params:{origins:e,destinations:r,mode:t,language:this.defaultLanguage,key:process.env.GOOGLE_MAPS_API_KEY||""}})).data;if(n.status!=="OK")throw new Error(`\u8DDD\u96E2\u77E9\u9663\u8A08\u7B97\u5931\u6557: ${n.status}`);let a=[],c=[];return n.rows.forEach(u=>{let i=[],p=[];u.elements.forEach(m=>{m.status==="OK"?(i.push({value:m.distance.value,text:m.distance.text}),p.push({value:m.duration.value,text:m.duration.text})):(i.push(null),p.push(null))}),a.push(i),c.push(p)}),{distances:a,durations:c,origin_addresses:n.origin_addresses,destination_addresses:n.destination_addresses}}catch(s){throw console.error("Error in calculateDistanceMatrix:",s),new Error("\u8A08\u7B97\u8DDD\u96E2\u77E9\u9663\u6642\u767C\u751F\u932F\u8AA4")}}async getDirections(e,r,t="driving",s,n){try{let a;n&&(a=Math.floor(n.getTime()/1e3));let c;a||(s instanceof Date?c=Math.floor(s.getTime()/1e3):s?c=s:c="now");let i=(await this.client.directions({params:{origin:e,destination:r,mode:t,language:this.defaultLanguage,key:process.env.GOOGLE_MAPS_API_KEY||"",arrival_time:a,departure_time:c}})).data;if(i.status!=="OK")throw new Error(`\u8DEF\u7DDA\u6307\u5F15\u7372\u53D6\u5931\u6557: ${i.status} (arrival_time: ${a}, departure_time: ${c})`);if(i.routes.length===0)throw new Error("\u627E\u4E0D\u5230\u8DEF\u7DDA");let p=i.routes[0],m=p.legs[0],O=y=>{if(!y||typeof y.value!="number")return"";let G=new Date(y.value*1e3),C={year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!1};return y.time_zone&&typeof y.time_zone=="string"&&(C.timeZone=y.time_zone),G.toLocaleString(this.defaultLanguage.toString(),C)};return{routes:i.routes,summary:p.summary,total_distance:{value:m.distance.value,text:m.distance.text},total_duration:{value:m.duration.value,text:m.duration.text},arrival_time:O(m.arrival_time),departure_time:O(m.departure_time)}}catch(a){throw console.error("Error in getDirections:",a),new Error("\u7372\u53D6\u8DEF\u7DDA\u6307\u5F15\u6642\u767C\u751F\u932F\u8AA4"+a)}}async getElevation(e){try{let r=e.map(n=>({lat:n.latitude,lng:n.longitude})),s=(await this.client.elevation({params:{locations:r,key:process.env.GOOGLE_MAPS_API_KEY||""}})).data;if(s.status!=="OK")throw new Error(`\u6D77\u62D4\u6578\u64DA\u7372\u53D6\u5931\u6557: ${s.status}`);return s.results.map((n,a)=>({elevation:n.elevation,location:r[a]}))}catch(r){throw console.error("Error in getElevation:",r),new Error("\u7372\u53D6\u6D77\u62D4\u6578\u64DA\u6642\u767C\u751F\u932F\u8AA4")}}};var l=class{constructor(){this.mapsTools=new N}async searchNearby(e){try{let r=await this.mapsTools.getLocation(e.center);console.error(r);let t=await this.mapsTools.searchNearbyPlaces({location:r,keyword:e.keyword,radius:e.radius,openNow:e.openNow,minRating:e.minRating});return{location:r,success:!0,data:t.map(s=>({name:s.name,place_id:s.place_id,address:s.formatted_address,location:s.geometry.location,rating:s.rating,total_ratings:s.user_ratings_total,open_now:s.opening_hours?.open_now}))}}catch(r){return{success:!1,error:r instanceof Error?r.message:"\u641C\u5C0B\u6642\u767C\u751F\u932F\u8AA4"}}}async getPlaceDetails(e){try{let r=await this.mapsTools.getPlaceDetails(e);return{success:!0,data:{name:r.name,address:r.formatted_address,location:r.geometry?.location,rating:r.rating,total_ratings:r.user_ratings_total,open_now:r.opening_hours?.open_now,phone:r.formatted_phone_number,website:r.website,price_level:r.price_level,reviews:r.reviews?.map(t=>({rating:t.rating,text:t.text,time:t.time,author_name:t.author_name}))}}}catch(r){return{success:!1,error:r instanceof Error?r.message:"\u7372\u53D6\u8A73\u7D30\u8CC7\u8A0A\u6642\u767C\u751F\u932F\u8AA4"}}}async geocode(e){try{return{success:!0,data:await this.mapsTools.geocode(e)}}catch(r){return{success:!1,error:r instanceof Error?r.message:"\u5730\u5740\u8F49\u63DB\u5EA7\u6A19\u6642\u767C\u751F\u932F\u8AA4"}}}async reverseGeocode(e,r){try{return{success:!0,data:await this.mapsTools.reverseGeocode(e,r)}}catch(t){return{success:!1,error:t instanceof Error?t.message:"\u5EA7\u6A19\u8F49\u63DB\u5730\u5740\u6642\u767C\u751F\u932F\u8AA4"}}}async calculateDistanceMatrix(e,r,t="driving"){try{return{success:!0,data:await this.mapsTools.calculateDistanceMatrix(e,r,t)}}catch(s){return{success:!1,error:s instanceof Error?s.message:"\u8A08\u7B97\u8DDD\u96E2\u77E9\u9663\u6642\u767C\u751F\u932F\u8AA4"}}}async getDirections(e,r,t="driving",s,n){try{let a=s?new Date(s):new Date,c=n?new Date(n):void 0;return{success:!0,data:await this.mapsTools.getDirections(e,r,t,a,c)}}catch(a){return{success:!1,error:a instanceof Error?a.message:"\u7372\u53D6\u8DEF\u7DDA\u6307\u5F15\u6642\u767C\u751F\u932F\u8AA4"}}}async getElevation(e){try{return{success:!0,data:await this.mapsTools.getElevation(e)}}catch(r){return{success:!1,error:r instanceof Error?r.message:"\u7372\u53D6\u6D77\u62D4\u6578\u64DA\u6642\u767C\u751F\u932F\u8AA4"}}}};var j="search_nearby",V="Search for nearby places based on location, with optional filtering by keywords, distance, rating, and operating hours",Y={center:g.object({value:g.string().describe("Address, landmark name, or coordinates (coordinate format: lat,lng)"),isCoordinates:g.boolean().default(!1).describe("Whether the value is coordinates")}).describe("Search center point"),keyword:g.string().optional().describe("Search keyword (e.g., restaurant, cafe, hotel)"),radius:g.number().default(1e3).describe("Search radius in meters"),openNow:g.boolean().default(!1).describe("Only show places that are currently open"),minRating:g.number().min(0).max(5).optional().describe("Minimum rating requirement (0-5)")},Z=new l;async function q(o){try{let e=await Z.searchNearby(o);return e.success?{content:[{type:"text",text:`location: ${JSON.stringify(e.location,null,2)}
+`+JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u641C\u5C0B\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u641C\u5C0B\u9644\u8FD1\u5730\u9EDE\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var h={NAME:j,DESCRIPTION:V,SCHEMA:Y,ACTION:q};import{z as W}from"zod";var F="get_place_details",B="Get detailed information about a specific place including contact details, reviews, ratings, and operating hours",U={placeId:W.string().describe("Google Maps place ID")},Q=new l;async function X(o){try{let e=await Q.getPlaceDetails(o.placeId);return e.success?{content:[{type:"text",text:JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u7372\u53D6\u8A73\u7D30\u8CC7\u8A0A\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u7372\u53D6\u5730\u9EDE\u8A73\u7D30\u8CC7\u8A0A\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var v={NAME:F,DESCRIPTION:B,SCHEMA:U,ACTION:X};import{z as ee}from"zod";var re="maps_geocode",te="Convert addresses or place names to geographic coordinates (latitude and longitude)",se={address:ee.string().describe("Address or place name to convert to coordinates")},oe=new l;async function ne(o){try{let e=await oe.geocode(o.address);return e.success?{content:[{type:"text",text:JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u5730\u5740\u8F49\u63DB\u5EA7\u6A19\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u5730\u5740\u8F49\u63DB\u5EA7\u6A19\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var E={NAME:re,DESCRIPTION:te,SCHEMA:se,ACTION:ne};import{z as I}from"zod";var ae="maps_reverse_geocode",ie="Convert geographic coordinates (latitude and longitude) to a human-readable address",ce={latitude:I.number().describe("Latitude coordinate"),longitude:I.number().describe("Longitude coordinate")},le=new l;async function de(o){try{let e=await le.reverseGeocode(o.latitude,o.longitude);return e.success?{content:[{type:"text",text:JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u5EA7\u6A19\u8F49\u63DB\u5730\u5740\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u5EA7\u6A19\u8F49\u63DB\u5730\u5740\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var P={NAME:ae,DESCRIPTION:ie,SCHEMA:ce,ACTION:de};import{z as _}from"zod";var ue="maps_distance_matrix",me="Calculate travel distances and durations between multiple origins and destinations for different travel modes",pe={origins:_.array(_.string()).describe("List of origin addresses or coordinates"),destinations:_.array(_.string()).describe("List of destination addresses or coordinates"),mode:_.enum(["driving","walking","bicycling","transit"]).default("driving").describe("Travel mode for calculation")},ge=new l;async function ye(o){try{let e=await ge.calculateDistanceMatrix(o.origins,o.destinations,o.mode);return e.success?{content:[{type:"text",text:JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u8A08\u7B97\u8DDD\u96E2\u77E9\u9663\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u8A08\u7B97\u8DDD\u96E2\u77E9\u9663\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var b={NAME:ue,DESCRIPTION:me,SCHEMA:pe,ACTION:ye};import{z as S}from"zod";var fe="maps_directions",he="Get detailed turn-by-turn navigation directions between two locations with route information",ve={origin:S.string().describe("Starting point address or coordinates"),destination:S.string().describe("Destination address or coordinates"),mode:S.enum(["driving","walking","bicycling","transit"]).default("driving").describe("Travel mode for directions"),departure_time:S.string().optional().describe("Departure time (ISO string format)"),arrival_time:S.string().optional().describe("Arrival time (ISO string format)")},Ee=new l;async function Pe(o){try{let e=await Ee.getDirections(o.origin,o.destination,o.mode,o.departure_time,o.arrival_time);return e.success?{content:[{type:"text",text:JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u7372\u53D6\u8DEF\u7DDA\u6307\u5F15\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u7372\u53D6\u8DEF\u7DDA\u6307\u5F15\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var w={NAME:fe,DESCRIPTION:he,SCHEMA:ve,ACTION:Pe};import{z as x}from"zod";var _e="maps_elevation",be="Get elevation data (height above sea level) for specific geographic locations",Se={locations:x.array(x.object({latitude:x.number().describe("Latitude coordinate"),longitude:x.number().describe("Longitude coordinate")})).describe("List of locations to get elevation data for")},we=new l;async function Me(o){try{let e=await we.getElevation(o.locations);return e.success?{content:[{type:"text",text:JSON.stringify(e.data,null,2)}],isError:!1}:{content:[{type:"text",text:e.error||"\u7372\u53D6\u6D77\u62D4\u6578\u64DA\u5931\u6557"}],isError:!0}}catch(e){return{isError:!0,content:[{type:"text",text:`\u7372\u53D6\u6D77\u62D4\u6578\u64DA\u932F\u8AA4: ${e instanceof Error?e.message:JSON.stringify(e)}`}]}}}var M={NAME:_e,DESCRIPTION:be,SCHEMA:Se,ACTION:Me};var Ne=[{name:"MCP-Server",portEnvVar:"MCP_SERVER_PORT",tools:[{name:f.NAME,description:f.DESCRIPTION,schema:f.SCHEMA,action:o=>f.ACTION(o)},{name:h.NAME,description:h.DESCRIPTION,schema:h.SCHEMA,action:o=>h.ACTION(o)},{name:v.NAME,description:v.DESCRIPTION,schema:v.SCHEMA,action:o=>v.ACTION(o)},{name:E.NAME,description:E.DESCRIPTION,schema:E.SCHEMA,action:o=>E.ACTION(o)},{name:P.NAME,description:P.DESCRIPTION,schema:P.SCHEMA,action:o=>P.ACTION(o)},{name:b.NAME,description:b.DESCRIPTION,schema:b.SCHEMA,action:o=>b.ACTION(o)},{name:w.NAME,description:w.DESCRIPTION,schema:w.SCHEMA,action:o=>w.ACTION(o)},{name:M.NAME,description:M.DESCRIPTION,schema:M.SCHEMA,action:o=>M.ACTION(o)}]}],R=Ne;import{McpServer as xe}from"@modelcontextprotocol/sdk/server/mcp.js";import{StreamableHTTPServerTransport as Ae}from"@modelcontextprotocol/sdk/server/streamableHttp.js";import{isInitializeRequest as Oe}from"@modelcontextprotocol/sdk/types.js";import D from"express";import{randomUUID as Ce}from"node:crypto";var Te="0.0.1",A=class{constructor(e,r){this.transports={};this.httpServer=null;this.serverName=e,this.server=new xe({name:this.serverName,version:Te},{capabilities:{logging:{},tools:{}}}),this.registerTools(r)}registerTools(e){e.forEach(r=>{this.server.tool(r.name,r.description,r.schema,async t=>r.action(t))})}async connect(e){await this.server.connect(e),d.log=(...t)=>{console.error("[INFO]",...t)},d.error=(...t)=>{console.error("[ERROR]",...t)};let r=process.stdout.write.bind(process.stdout);process.stdout.write=(t,s,n)=>typeof t=="string"&&!t.startsWith("{")?!0:r(t,s,n),d.log(`${this.serverName} connected and ready to process requests`)}async startHttpServer(e){let r=D();r.use(D.json()),r.post("/mcp",async(a,c)=>{let u=a.headers["mcp-session-id"],i;if(u&&this.transports[u])i=this.transports[u];else if(!u&&Oe(a.body))i=new Ae({sessionIdGenerator:()=>Ce(),onsessioninitialized:p=>{this.transports[p]=i,console.log(`[${this.serverName}] New session initialized: ${p}`)}}),i.onclose=()=>{i.sessionId&&(delete this.transports[i.sessionId],console.log(`[${this.serverName}] Session closed: ${i.sessionId}`))},await this.server.connect(i);else{c.status(400).json({jsonrpc:"2.0",error:{code:-32e3,message:"Bad Request: No valid session ID provided"},id:null});return}await i.handleRequest(a,c,a.body)});let t=async(a,c)=>{let u=a.headers["mcp-session-id"];if(!u||!this.transports[u]){c.status(400).send("Invalid or missing session ID");return}await this.transports[u].handleRequest(a,c)};r.get("/mcp",t),r.delete("/mcp",t);let s=console.log,n=console.error;d.log=s,d.error=n,this.httpServer=r.listen(e,()=>{d.log(`[${this.serverName}] HTTP server listening on port ${e}`),d.log(`[${this.serverName}] MCP endpoint available at http://localhost:${e}/mcp`)})}async stopHttpServer(){if(!this.httpServer){d.error(`[${this.serverName}] HTTP server is not running or already stopped.`);return}return new Promise((e,r)=>{this.httpServer.close(t=>{if(t){d.error(`[${this.serverName}] Error stopping HTTP server:`,t),r(t);return}d.log(`[${this.serverName}] HTTP server stopped.`),this.httpServer=null;let s=Object.values(this.transports).map(n=>(n.sessionId&&delete this.transports[n.sessionId],Promise.resolve()));Promise.all(s).then(()=>{d.log(`[${this.serverName}] All transports closed.`),e()}).catch(n=>{d.error(`[${this.serverName}] Error during bulk transport closing:`,n),r(n)})})})}};Ie({path:Re(process.cwd(),".env")});async function $e(o,e){o&&(process.env.MCP_SERVER_PORT=o.toString()),e&&(process.env.GOOGLE_MAPS_API_KEY=e),console.log("\u{1F680} Starting Google Maps MCP Server..."),console.log("\u{1F4CD} Available tools: search_nearby, get_place_details, maps_geocode, maps_reverse_geocode, maps_distance_matrix, maps_directions, maps_elevation, echo"),console.log("");let r=R.map(async t=>{let s=process.env[t.portEnvVar];if(!s){console.warn(`\u26A0\uFE0F  [${t.name}] Port environment variable ${t.portEnvVar} not set.`),console.log(`\u{1F4A1} Please set ${t.portEnvVar} in your .env file or use --port parameter.`),console.log(`   Example: ${t.portEnvVar}=3000 or --port 3000`);return}let n=Number(s);if(isNaN(n)||n<=0){console.error(`\u274C [${t.name}] Invalid port number "${s}" defined in ${t.portEnvVar}.`);return}try{let a=new A(t.name,t.tools);console.log(`\u{1F527} [${t.name}] Initializing MCP Server in HTTP mode on port ${n}...`),await a.startHttpServer(n),console.log(`\u2705 [${t.name}] MCP Server started successfully!`),console.log(`   \u{1F310} Endpoint: http://localhost:${n}/mcp`),console.log(`   \u{1F4DA} Tools: ${t.tools.length} available`)}catch(a){console.error(`\u274C [${t.name}] Failed to start MCP Server on port ${n}:`,a)}});await Promise.allSettled(r),console.log(""),console.log("\u{1F389} Server initialization completed!"),console.log("\u{1F4A1} Need help? Check the README.md for configuration details.")}if(process.argv[1]&&(process.argv[1].endsWith("cli.ts")||process.argv[1].endsWith("cli.js"))){let o=De(Ge(process.argv)).option("port",{alias:"p",type:"number",description:"Port to run the MCP server on",default:process.env.MCP_SERVER_PORT?parseInt(process.env.MCP_SERVER_PORT):3e3}).option("apikey",{alias:"k",type:"string",description:"Google Maps API key",default:process.env.GOOGLE_MAPS_API_KEY}).option("help",{alias:"h",type:"boolean",description:"Show help"}).example([["$0","Start server with default settings"],['$0 --port 3000 --apikey "your_api_key"',"Start server with custom port and API key"],['$0 -p 3001 -k "your_api_key"',"Start server with short options"]]).help().parseSync();console.log("\u{1F5FA}\uFE0F  Google Maps MCP Server"),console.log("   A Model Context Protocol server for Google Maps services"),console.log(""),o.apikey||(console.log("\u26A0\uFE0F  Google Maps API Key not found!"),console.log("   Please provide --apikey parameter or set GOOGLE_MAPS_API_KEY in your .env file"),console.log("   Example: mcp-google-map --apikey your_api_key_here"),console.log("   Or: GOOGLE_MAPS_API_KEY=your_api_key_here"),console.log("")),$e(o.port,o.apikey).catch(e=>{console.error("\u274C Failed to start server:",e),process.exit(1)})}export{$e as startServer};

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+declare enum ImagePurpose {
+    DISPLAY = "display",
+    LLM = "llm"
+}
+declare const Logger: {
+    log: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+};
+
+export { ImagePurpose, Logger };