Mo Bus

An MCP server that provides AI-powered bus route planning for Bhubaneswar, Cuttack, and Puri using geocoding, stops, routes, and fare data.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "himanshumohanty-git24-mobusmcp": {
      "command": "python",
      "args": [
        "-m",
        "src.server"
      ],
      "env": {
        "LOG_LEVEL": "INFO",
        "DEBUG_MODE": "false",
        "PYTHONPATH": "<path-to-MoBusMCP>",
        "API_TIMEOUT": "30",
        "SERPAPI_KEY": "YOUR_SERPAPI_KEY",
        "MAX_WALKING_DISTANCE": "5"
      }
    }
  }
}

You install and run the Mo Bus MCP Server to empower any AI assistant with intelligent bus route planning for Bhubaneswar, Cuttack, and Puri. The server translates natural language queries into actionable journey plans by combining geocoding, route data, and fare calculations, then returns clear options you can act on in your AI client of choice.

How to use

Ask your MCP-enabled AI assistant to plan a trip using plain language. You can request multi-leg journeys, walking distances to stops, total travel time, and fare estimates. For example, you can say: “Plan my morning commute from KIIT Campus to Accenture near Acharya Vihar Square at 8:30 AM,” or “What buses stop at Master Canteen, and what are the walking steps from the nearest stop?” The server responds with bus numbers, walking distances to the closest stops, journey time, fare, and alternative routes when available.

How to install

Prerequisites: you need Python 3.10 or higher, a Python package manager, and optionally a SerpAPI key for enhanced geocoding.

Step 1: Clone the project repository.

Step 2: Create and activate a virtual environment.

Step 3: Install dependencies.

Step 4: Start the MCP server.

Configuration and usage notes

The server can be run locally via a standard stdio configuration. The runtime command starts the MCP server by executing Python and loading the module that serves MCP requests.

Example of a local stdio configuration to connect from an MCP client (such as Claude Desktop) via a local process:

Configuration example (stdio)

{
  "name": "mo_bus",
  "type": "stdio",
  "command": "python",
  "args": ["-m", "src.server"],
  "env": {
    "PYTHONPATH": "<path-to-MoBusMCP>",
    "SERPAPI_KEY": "your_serpapi_key_here"
  }
}

Available tools

Journey Planner

Calculates multi-leg routes, considers walking distances, and provides ETA and fare estimates.

Route Finder

Finds available bus routes between a start and end location using geocoding data.

Fare Calculator

Estimates total fare based on distance and chosen routes.

Geocoding Service

Converts addresses and landmarks to coordinates using SerpAPI and OpenStreetMap.

Built by

VeilStrat

AI signals for GTM teams