Skip to main content
Glama
Sign In
deenesjakoruzh

Bangalore BMTC Mobility Connectivity Platform

by ajeetraina
GitHub
JavaScript
MIT License
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bengaluru BMTC MCP Server

An implementation of a Model Context Protocol (MCP) server for Bangalore Metropolitan Transport Corporation (BMTC) bus services.

Architecture

The BMTC MCP server follows a modular, layered architecture. The system is designed to handle real-time transit data from Bangalore Metropolitan Transport Corporation buses and provide it through a standardized API.

Core Components

  1. API Layer: RESTful endpoints for authentication, routes, stops, bus locations, and ETA information
  2. Service Layer: Business logic, data transformation, and ETA calculations
  3. Data Access Layer: MongoDB integration via Mongoose ODM
  4. Caching Layer: Redis-based caching for improved performance
  5. External Integration Layer: BMTC API integration

Read the full architecture documentation

Features

Here're the list of things that you can find using MCP Client or chat window:

  • Real-time bus location tracking
  • Route information and scheduling
  • Stop details and ETA (Estimated Time of Arrival)
  • Support for over 2,200 bus routes and 8,400+ bus stops in Bengaluru
  • Authentication and authorization
  • Data caching and optimization
  • GeoSpatial queries for nearby stops and buses

Prerequisites

  • Node.js (v14 or later)
  • npm or yarn
  • MongoDB
  • Redis (optional, for caching)
  • Git

Installation and Setup

Method 1: Standard Installation

  1. Clone the repository
git clone https://github.com/ajeetraina/bengaluru-bmtc-mcp.git cd bengaluru-bmtc-mcp
  1. Install dependencies
npm install
  1. Configure environment variables
cp .env.example .env

Edit the .env file with your configuration:

PORT=3000 NODE_ENV=development MONGO_URI=mongodb://localhost:27017/bmtc-mcp REDIS_URI=redis://localhost:6379 API_KEY=your_api_key_here JWT_SECRET=your_jwt_secret_here JWT_EXPIRES_IN=86400 BMTC_API_ENDPOINT=https://bmtc-api-endpoint.example BMTC_API_KEY=your_bmtc_api_key_here CACHE_DURATION=300 LOG_LEVEL=info
  1. Seed the database with mock data (optional)
node src/scripts/seed.js
  1. Start the server
npm start

For development with auto-restart:

npm run dev

Method 2: Using Docker Compose

  1. Clone the repository
git clone https://github.com/ajeetraina/bengaluru-bmtc-mcp.git cd bengaluru-bmtc-mcp
  1. Configure environment variables (optional)

You can modify the environment variables directly in the docker-compose.yml file or create a .env file:

cp .env.example .env
  1. Build and start the containers
docker-compose up -d

This will start three containers:

  • bmtc-mcp-api: The Node.js API server
  • bmtc-mcp-mongo: MongoDB database
  • bmtc-mcp-redis: Redis cache server
  1. Seed the database with mock data (optional)
docker-compose exec api node src/scripts/seed.js
  1. View logs
docker-compose logs -f api
  1. Stop the containers
docker-compose down

To remove volumes as well:

docker-compose down -v

Using the API

Once the server is running, you can access the API at:

http://localhost:3000/api/v1

For API documentation, visit:

http://localhost:3000/api-docs

Example API Endpoints

# Authentication POST /api/v1/auth/login GET /api/v1/auth/me # Routes GET /api/v1/routes GET /api/v1/routes/:routeId GET /api/v1/routes/search?source=Kempegowda&destination=Electronic # Stops GET /api/v1/stops GET /api/v1/stops/:stopId GET /api/v1/stops/near?lat=12.9767&lng=77.5713&radius=500 GET /api/v1/stops/search?query=Lalbagh # Bus Locations GET /api/v1/bus-locations GET /api/v1/bus-locations/:busId GET /api/v1/bus-locations/near?lat=12.9767&lng=77.5713&radius=1000 # ETA GET /api/v1/eta/:stopId GET /api/v1/eta/:stopId/:routeId

API Keys

JWT Secret

The JWT secret is used for signing authentication tokens. Generate a secure random string:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Add this to your .env file:

JWT_SECRET=your_generated_secret_here

BMTC API Key

For development, you can use mock data without an actual BMTC API key:

BMTC_API_ENDPOINT=https://bmtc-api-endpoint.example BMTC_API_KEY=your_bmtc_api_key_here

For production, you would need to contact BMTC directly to request official API access.

Development

Testing

Run the tests:

npm test

Run tests with coverage:

npm run test:coverage

Linting

Check code style:

npm run lint

Fix code style issues:

npm run lint:fix

Project Structure

bengaluru-bmtc-mcp/ ├── .env.example # Environment variables template ├── .eslintrc.json # ESLint configuration ├── .github/ # GitHub configuration │ └── workflows/ # GitHub Actions workflows ├── .gitignore # Git ignore file ├── CONTRIBUTING.md # Contribution guidelines ├── Dockerfile # Docker configuration ├── LICENSE # MIT License ├── README.md # Project documentation ├── docker-compose.yml # Docker Compose configuration ├── docs/ # Documentation │ ├── api.md # API documentation │ └── setup.md # Setup guide ├── jest.config.js # Jest configuration ├── package.json # Project dependencies └── src/ # Source code ├── config/ # Configuration files ├── controllers/ # Request handlers ├── index.js # Application entry point ├── middlewares/ # Express middlewares ├── models/ # MongoDB models ├── public/ # Static files ├── routes/ # API routes ├── scripts/ # Utility scripts ├── services/ # External service integrations ├── tests/ # Test files └── utils/ # Utility functions

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides real-time access to Bangalore's public transportation information including bus tracking, schedules, routes, and service updates to improve passenger experience.

  1. Architecture
    1. Core Components
  2. Features
    1. Prerequisites
      1. Installation and Setup
        1. Method 1: Standard Installation
        2. Method 2: Using Docker Compose
      2. Using the API
        1. Example API Endpoints
      3. API Keys
        1. JWT Secret
        2. BMTC API Key
      4. Development
        1. Testing
        2. Linting
        3. Project Structure
      5. Contributing
        1. License
          1. Acknowledgements

            Related MCP Servers

            • Vilnius Transport MCP Server

              sarunasdaujotis
              A
              security
              F
              license
              A
              quality
              Enables Large Language Models to access real-time data on Vilnius public transport stops and routes through the Model Context Protocol.
              Last updated -
              2
              1
              Python

            • Singapore LTA MCP Server

              arjunkmrm
              A
              security
              F
              license
              A
              quality
              Facilitates real-time access to Singapore's Land Transport Authority (LTA) transportation data, offering insights into bus arrivals, train services, traffic conditions, and more through integration with the LTA DataMall API.
              Last updated -
              7
              JavaScript

            • TfNSW Realtime Alerts MCP Server

              piddlingtuna
              -
              security
              A
              license
              -
              quality
              This server enables large language models to access and interact with real-time transport alerts from Transport for NSW's network, supporting filtering by transport mode and returning formatted alert information about disruptions and planned works.
              Last updated -
              11
              5
              JavaScript
              MIT License
              • Apple

            • KMB Bus MCP Server

              kennyckk
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that provides real-time access to Hong Kong's KMB and Long Win Bus route information and arrival times, enabling Language Models to answer user questions about bus routes, stops, and ETAs.
              Last updated -
              3
              Python
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/ajeetraina/bengaluru-bmtc-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server