@cablate/mcp-google-map 0.0.15 → 0.0.16

package/README.md

@@ -16,6 +16,7 @@ Special thanks to [@junyinnnn](https://github.com/junyinnnn) for helping add sup
 ## ✅ Testing Status
 
 **This MCP server has been tested and verified to work correctly with:**
+
 - Claude Desktop
 - Dive Desktop
 - MCP protocol implementations
@@ -27,14 +28,17 @@ All tools and features are confirmed functional through real-world testing.
 ### 🗺️ 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)
@@ -51,43 +55,94 @@ All tools and features are confirmed functional through real-world testing.
 
 ## Installation
 
-### 1. via NPM
+> ⚠️ **Important Notice**: This server uses HTTP transport, not stdio. Direct npx usage in MCP Server Settings is **NOT supported**.
+
+### Method 1: Global Installation (Recommended)
 
 ```bash
+# Install globally
 npm install -g @cablate/mcp-google-map
+
+# Run the server
+mcp-google-map --port 3000 --apikey "your_api_key_here"
+
+# Using short options
+mcp-google-map -p 3000 -k "your_api_key_here"
 ```
 
-### 2. Run the Server
+### Method 2: Using npx (Quick Start)
+
+> ⚠️ **Warning**: Cannot be used directly in MCP Server Settings with stdio mode
+
+**Step 1: Launch HTTP Server in Terminal**
 
 ```bash
+# Run in a separate terminal
+npx @cablate/mcp-google-map --port 3000 --apikey "YOUR_API_KEY"
 
-mcp-google-map --port 3000 --apikey "your_api_key_here"
+# Or with environment variable
+GOOGLE_MAPS_API_KEY=YOUR_API_KEY npx @cablate/mcp-google-map
+```
 
-# Using short options
-mcp-google-map -p 3000 -k "your_api_key_here"
+**Step 2: Configure MCP Client to Use HTTP**
 
-# Show help information
-mcp-google-map --help
+```json
+{
+  "mcp-google-map": {
+    "transport": "http",
+    "url": "http://localhost:3000/mcp"
+  }
+}
 ```
 
-### 3. Server Endpoints
+### ❌ Common Mistake to Avoid
 
-- **Main MCP Endpoint**: `http://localhost:3000/mcp`
-- **Available Tools**: 8 tools including Google Maps services and echo
+```json
+// This WILL NOT WORK - stdio mode not supported with npx
+{
+  "mcp-google-map": {
+    "command": "npx",
+    "args": ["@cablate/mcp-google-map"]
+  }
+}
+```
 
-### Environment Variables
+### Server Information
 
-Alternatively, create a `.env` file in your working directory:
+- **Endpoint**: `http://localhost:3000/mcp`
+- **Transport**: HTTP (not stdio)
+- **Tools**: 8 Google Maps tools available
 
-```env
-# Required
-GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here
+### API Key Configuration
 
-# Optional
-MCP_SERVER_PORT=3000
-```
+API keys can be provided in three ways (priority order):
+
+1. **HTTP Headers** (Highest priority)
+
+   ```json
+   // MCP Client config
+   {
+     "mcp-google-map": {
+       "transport": "streamableHttp",
+       "url": "http://localhost:3000/mcp",
+       "headers": {
+         "X-Google-Maps-API-Key": "YOUR_API_KEY"
+       }
+     }
+   }
+   ```
 
-**Note**: Command line options take precedence over environment variables.
+2. **Command Line**
+
+   ```bash
+   mcp-google-map --apikey YOUR_API_KEY
+   ```
+
+3. **Environment Variable** (.env file or command line)
+   ```env
+   GOOGLE_MAPS_API_KEY=your_api_key_here
+   MCP_SERVER_PORT=3000
+   ```
 
 ## Available Tools
 
@@ -192,7 +247,15 @@ If you have any questions or suggestions, feel free to reach out:
 
 ## Changelog
 
+### v0.0.15 (Latest)
+
+- **Added HTTP Header Authentication**: Support for passing API keys via `X-Google-Maps-API-Key` header in MCP Client config
+- **Fixed Concurrent User Issues**: Each session now uses its own API key without conflicts
+- **Fixed npx Execution**: Resolved module bundling issues
+- **Improved Documentation**: Clearer setup instructions
+
 ### v0.0.5
+
 - Added streamable HTTP transport support
 - Improved CLI interface with emoji indicators
 - Enhanced error handling and logging
@@ -200,6 +263,7 @@ If you have any questions or suggestions, feel free to reach out:
 - 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-W2DM2HDK.js

@@ -0,0 +1 @@
+var r={log:(...o)=>{console.error("[INFO]",...o)},error:(...o)=>{console.error("[ERROR]",...o)}};export{r as a};