Singapore Location Intelligence MCP

Provides real-time Singapore transport data and routing information.

As the creator of this project, I, Siva (Sivasubramanian Ramanathan), developed this comprehensive Singapore Location Intelligence Platform to explore the capabilities of the Model Context Protocol (MCP). My goal was to test how MCP could be leveraged to help AI accurately plan routes, while also showcasing my ability to work with various APIs and my expertise in the technologies involved.

What began as an experiment with MCP integration evolved into a sophisticated, real-world application that demonstrates the power of this exciting new protocol to create tools that can rival commercial solutions. This platform provides enterprise-grade transport routing, postal code resolution, and location intelligence with Google Maps-level detailed navigation instructions, all optimized for Singapore's unique transport ecosystem.

🎯NEW in v0.3.0- MRT Exit Integration & Landmarks Tool Fix

- 🚇MRT Exit Recommendations- Google Maps-level precision with specific exit codes
- 🏛️Enhanced Location Resolution- Fixed JSON string parsing and coordinate validation
- 📍Exit-Level Navigation- "Use Exit E (14m walk, 1 min)" for optimal station navigation
- 🔧Robust Input Handling- All location formats now work correctly
- 🎯Singapore-Optimized- Proper coordinate bounds and postal code validation

🎯v0.2.7- Weather Service Fixes & Enhanced Reliability

- 🌦️Robust Weather Integration- Fixed all weather API inconsistencies and crashes
- 🔧Production-Ready Error Handling- Graceful degradation when weather APIs fail
- 🎯Singapore Weather API Compatibility- Supports all 5 official weather endpoints
- ⚡Enhanced Journey Planning- Weather-aware routing with resilient fallbacks
- 🛡️Zero-Crash Guarantee- Weather service failures no longer break journey planning

- 🌦️Standalone Weather Tools- Comprehensive weather conditions and activity-specific advisories
- 🎯Activity Recommendations- Tailored advice for walking, cycling, sports, photography, dining
- 🌡️Comfort Analysis- Intelligent comfort level assessment with travel impact
- ⏰Best Time Recommendations- Optimal timing for outdoor activities based on weather

- 🔍Advanced Fuzzy Search- "Opp Blk 910" → finds "Opposite Block 910" with 95% accuracy
- 🌦️Weather-Aware Routing- Real-time weather impact on walking times and route suggestions
- 🚇Transfer Minimization- Smart algorithms to reduce transfers in multi-modal journeys
- 🗺️Google Maps-Quality Directions- "Turn Left To Stay On Thomson Road" level instructions
- 📍Comprehensive Stop Details- Nearby amenities, accessibility info, and location context

- 🎯Advanced Postal Code Intelligence- 95% accuracy resolution for all Singapore postal codes
- 🗺️Professional Navigation Instructions- Turn-by-turn directions like "Turn Left To Stay On Thomson Road"
- 🚇Multi-Modal Transport Planning- Seamless integration of MRT, LRT, buses, and walking
- ⏰Singapore Time Intelligence- Business hours, rush hour detection, and timing optimization
- 🔍Intelligent Location Search- Fuzzy matching, typo tolerance, and smart suggestions
- 📍Comprehensive Geocoding- Forward and reverse geocoding with Singapore-specific accuracy
- 🚌Real-Time Transport Data- Live bus arrivals, train status, and service disruptions
- 💡Context-Aware Routing- Peak hour optimization, last train warnings, night bus alternatives

Before: Basic transport tools with failed postal code resolutionAfter: Enterprise-grade location intelligence platform with weather-aware routing

INPUT: "How to get to Suntec City from Little India MRT during heavy rain?" OUTPUT: ✅ Postal Code 039594 → SUNTEC CITY 🌧️ Heavy rain detected - prefer covered routes 🚇 Route: DT Line (8 min) → Covered walkway (6 min) 💰 Cost: $1.55 | 🕐 Duration: 32 minutes (adjusted for weather) 📍 Step-by-step: "Walk 246m via covered walkway to ROCHOR MRT → Take DT Line from Rochor to Promenade → Use underground connection to Suntec City" ⚠️ Weather Advisory: Allow extra 5 minutes for walking segments

Add to yourclaude_desktop_config.json:

{ "mcpServers": { "singapore-transport": { "command": "npx", "args": ["-y", "@siva-sub/mcp-public-transport"], "env": { "LTA_ACCOUNT_KEY": "your_lta_api_key_here", "ONEMAP_TOKEN": "your_onemap_token_here", "ONEMAP_EMAIL": "your_onemap_email@example.com", "ONEMAP_PASSWORD": "your_onemap_password" } } } }

- LTA_ACCOUNT_KEY:Required. Your LTA DataMall API key (Get here)

- ONEMAP_TOKEN: OneMap API token for enhanced features (Register here)
- ONEMAP_EMAIL: OneMap account email for authentication
- ONEMAP_PASSWORD: OneMap account password for authentication
- CACHE_DURATION: Cache duration in seconds (default:300)
- LOG_LEVEL: Logging level (default:info)

// Weather-aware journey planning { "primaryRoute": { "summary": { "totalTime": 1980, // seconds (adjusted for weather) "walkingTime": 720, // includes weather buffer "transfers": 1 }, "weatherImpact": { "conditions": { "rainfall": 12.5, // mm "temperature": 28, // °C "humidity": 85 // % }, "advisories": [ { "severity": "high", "type": "rain", "message": "Heavy rain detected. Allow extra time for walking.", "routingImpact": { "walkingTimeMultiplier": 1.5, "preferredModes": ["MRT", "Covered Bus Stops"] } } ] } } }

// Fuzzy search with Singapore intelligence { "query": "Opp Blk 910", "searchType": "fuzzy", "results": [ { "busStopCode": "83139", "description": "OPP BLK 910", "matchScore": 0.95, "locationPatterns": { "blockNumber": "910", "direction": "opp" }, "searchContext": { "queryVariations": ["opposite block 910", "opp blk 910"], "bestMatch": "OPP BLK 910" } } ] }

// Detailed stop information with context { "details": { "busStopCode": "83139", "description": "OPP BLK 910", "services": [...], // Real-time arrivals "nearbyStops": [...], // Within walking distance "accessibility": { "wheelchairAccessible": true, "sheltered": true, "tactilePaving": true }, "locationContext": { "district": "Tampines", "landmarks": ["Block 910", "Tampines Mall"], "transportHubs": ["Tampines MRT Station"] }, "nearbyAmenities": [ { "name": "Tampines Mall", "type": "shopping", "distance": 250, "walkingTime": 3 } ] } }

{ "singaporeTime": "27/06/2025, 10:58 PM", "businessHours": false, "rushHour": false, "contextInfo": { "nextRushHour": "7:00 AM tomorrow", "travelRecommendation": "Off-peak travel - comfortable journey expected" } }

{ "postalCode": "039594", "location": { "name": "SUNTEC CITY", "address": "3 TEMASEK BOULEVARD SUNTEC CITY SINGAPORE 039594", "district": "Downtown Core", "areaType": "Central Singapore", "confidence": 0.98 } }

- Weather-aware route planning
- Detailed turn-by-turn directions
- Multi-modal journey optimization
- Real-time traffic integration

- Postal code validation and resolution
- Optimal route planning with weather considerations
- Address standardization and fuzzy matching

- Transport accessibility analysis
- Weather impact on pedestrian traffic
- Peak hour traffic optimization
- Public transport coverage mapping

- Tourist-friendly directions with landmarks
- Weather-appropriate route suggestions
- Public transport guidance
- Location discovery with fuzzy search

- Sub-3-second route planningwith weather integration
- 5-minute weather data cachefor real-time responsiveness
- Intelligent cachingwith location and weather-aware TTL
- Graceful degradationduring API maintenance
- 95% postal code resolution accuracy
- Real-time data integrationwith official Singapore APIs
- Fuzzy search accuracyof 90%+ for Singapore terms

{ "routingOptions": { "includeWeatherImpact": true, "maxWalkingDistance": 800, "weatherSensitivity": "high", "preferredModes": ["MRT", "Covered Bus Stops"], "minimizeTransfers": true } }

{ "searchOptions": { "enableFuzzySearch": true, "minScore": 0.3, "singaporeAbbreviations": true, "typoTolerance": true } }

{ "businessHours": { "weekdays": { "start": 9, "end": 18 }, "saturday": { "start": 9, "end": 13 }, "sunday": { "closed": true } } }

- Authentication: Automatic token refresh with 3-day TTL
- Geocoding: High-accuracy address resolution with fuzzy matching
- Routing: Professional-grade turn-by-turn directions
- Weather Integration: Real-time weather data from Singapore APIs

- Real-time Data: Bus arrivals, train status, traffic conditions
- Transport Network: Complete bus and train network data
- Service Alerts: Live disruption and maintenance notifications
- Enhanced Error Handling: Graceful degradation and retry logic

- Real-time Data: Rainfall, temperature, humidity, wind speed
- 5-minute Updates: Fresh weather data for accurate routing
- Location-based: Weather conditions for specific route segments
- Advisory Generation: Smart recommendations based on conditions

git clone https://github.com/siva-sub/MCP-Public-Transport cd MCP-Public-Transport npm install cp .env.example .env.local # Add your API keys to .env.local npm run dev

npm run build # Builds both ESM and CJS versions npm run test # Runs comprehensive test suite npm run lint # TypeScript and ESLint checks

# Unit tests npm run test # Integration tests with real APIs npm run test:integration # Performance tests npm run test:performance

src/ ├── services/ # Core business logic │ ├── lta.ts # LTA DataMall integration │ ├── onemap.ts # OneMap API with authentication │ ├── weather.ts # ⭐ Real-time weather integration │ ├── routing.ts # ⭐ Enhanced multi-modal routing │ ├── fuzzySearch.ts # ⭐ Singapore-optimized fuzzy search │ ├── time.ts # Singapore time intelligence │ ├── postalCode.ts # Postal code validation & resolution │ └── cache.ts # Intelligent caching layer ├── tools/ # MCP tool implementations │ ├── location/ # Enhanced location intelligence tools │ ├── bus/ # ⭐ Enhanced bus tools with fuzzy search │ │ ├── search.ts # ⭐ Advanced bus stop search │ │ └── details.ts # ⭐ Comprehensive stop details │ ├── routing/ # ⭐ Enhanced journey planning tools │ │ └── enhanced.ts# ⭐ Weather-aware optimal routing │ ├── train/ # Train service tools │ └── traffic/ # Traffic and road tools ├── types/ # TypeScript interfaces │ ├── location.ts # Location and search types │ ├── transport.ts # Transport system types │ ├── search.ts # Search and query types │ └── time.ts # Singapore time types └── utils/ # Shared utilities ├── errors.ts # Custom error handling ├── logger.ts # Structured logging └── validation.ts # Input validation

- Singapore-Optimized: Built specifically for Singapore's unique transport ecosystem with local intelligence
- Weather-Aware: Real-time weather integration affects routing decisions and walking time estimates
- Professional-Grade: Routing instructions comparable to Google Maps with fuzzy search capabilities
- Real-Time Context: Business hours, rush hour, weather, and timing intelligence
- High Accuracy: 95% success rate for postal code resolution, 90%+ fuzzy search accuracy
- Enterprise-Ready: Comprehensive error handling, weather resilience, and performance optimization
- Developer-Friendly: Full TypeScript support with comprehensive documentation
- Transfer Minimization: Smart algorithms to reduce transfers in multi-modal journeys

We welcome contributions! Please see ourContributing Guidefor details.

Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.