Bus Nearby MCP

A Model Context Protocol (MCP) server that provides access to the Israeli transport api.
This is the Unofficial MCP of Bus Nearby API,You can check this API here

https://github.com/user-attachments/assets/147ee388-e9c0-4f97-82e7-71d4d6534de0

- Cursor IDE (or any other MCP client)
- Docker Engine

{ "mcpServers": { "busnearby-docker": { "command": "docker", "args": ["run", "--rm", "-i", "shmuelc/busnearby-mcp:latest"] } } }

{ "mcpServers": { "busnearby": { "command": "docker", "args": [ "run", "--rm", "-i", "--name", "busnearby-mcp-cursor", "busnearby-mcp" ], "env": {} } } }

- Node.js 18+ installed
- npm or yarn
- Cursor IDE

{ "mcpServers": { "busnearby": { "command": "node", "args": ["/Users/shmuel/Desktop/personal/busnearby-mcp/dist/main.js"], "env": {} } } }

Important:Replace the path with your actual project path.

Restart Cursorto load the new MCP server

Convert location queries to coordinates.

- locale: "he" or "en" (Hebrew or English)
- query: Location string (e.g., "תל אביב" or "Tel Aviv")

{ "locale": "he", "query": "תל אביב" }

Get transit directions between locations.

- fromPlace: Starting location ("address::lat,lng")
- toPlace: Destination ("address::lat,lng")
- locale: "he" or "en" (default: "he")
- arriveBy: Optimize for arrival time (default: false)
- wheelchair: Wheelchair accessible (default: false)
- mode: Transport modes (default: "WALK,TRANSIT")
- numItineraries: Number of routes (default: 3)
- date: Trip date (YYYY-MM-DD, optional)
- time: Trip time (HH:MM, optional)

# Build the image docker build -t busnearby-mcp . # Run with docker-compose docker-compose up -d # Run interactively for testing docker run --rm -i busnearby-mcp # Test MCP protocol echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"clientInfo":{"name":"test","version":"1.0.0"}}}' | docker run --rm -i busnearby-mcp

npm run build npm start npm run test:e2e

- Ensure Docker is running
- Try rebuilding:docker build --no-cache -t busnearby-mcp .
- Check logs:docker logs busnearby-mcp

- Restart Cursor after configuration changes
- Check MCP configuration path is correct
- Verify Docker image exists:docker images | grep busnearby-mcp

- Test server directly:echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"clientInfo":{"name":"test","version":"1.0.0"}}}' | docker run --rm -i busnearby-mcp
- Check for JSON-RPC format in responses

This MCP server interfaces with the Bus Nearby API to provide:

- Location geocoding in multiple languages
- Multi-modal transit routing
- Real-time schedule information
- Accessibility features

All responses follow standard MCP protocol formatting with proper error handling.

- 🐛 Report bugs or issues
- 💡 Suggest new features or improvements
- 📖 Improve documentation
- 🔧 Submit pull requests
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request

All contributions are welcome and appreciated!

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Unlock geospatial intelligence through Mapbox APIs like geocoding, POI search, directions, isochrones and more.

Free business data API and MCP server. Find restaurants, cafes, hotels, shops and 37+ business categories in any city worldwide. Uses OpenStreetMap data. No API key required. REST API + MCP Streamable HTTP endpoint.

Provides geolocation and nearby POI (Point of Interest) information using the Gaode Map API.

Provides geocoding services by integrating with the Nominatim API.

An MCP server for interacting with the Google Maps API, designed for Google Cloud Run.

STDIO-based MCP server for Google Maps Platform APIs

Provides directions, place search, and geocoding features using the Naver Maps API.

IP2Location.io API integration to retrieve the geolocation information for an IP address.

Search the web using Kagi's search API

Interact & query with Meilisearch (Full-text & semantic search API)