Synchro Bus MCP Server

A Model Context Protocol server for accessing the Synchro Bus (Instant-System) API. This server provides access to various endpoints of the Instant-System API v3, specifically for the Synchro Bus network (ID: 3).

Features

The server exposes the following API endpoints:

- networkGet: Get network information
- linesGet: Get all lines for a network
- lineGet: Get information about a specific line
- lineStopAreasGet: Get stop areas for a line
- lineStopAreaSchedulesGet: Get schedules for a stop area on a line
- disruptionsGet: Get disruptions for a network
- vehicleJourneysDirectionsGet: Get vehicle journey directions for a line

Installation

1. Clone the repository
2. Install dependencies:

   npm install

   

3. Copy the example environment file and update it with your settings:

   cp .env.example .env

   

4. Build the project:

   npm run build

   

Configuration

Create a .env file in the root directory with the following variables:

INSTANT_SYSTEM_BASE_URL=https://prod.instant-system.com/InstantCore

Usage

Start the server:

npm start

For development with auto-reload:

npm run dev

API Reference

networkGet

Get information about the Synchro Bus network.

linesGet

Get all lines available in the network.

lineGet

Get detailed information about a specific line.

lineStopAreasGet

Get all stop areas for a specific line.

lineStopAreaSchedulesGet

Get schedules for a specific stop area on a line.

disruptionsGet

Get current disruptions in the network.

vehicleJourneysDirectionsGet

Get available directions for vehicle journeys on a line.

Development

- npm run build - Build the project
- npm run dev - Start the server in development mode with auto-reload
- npm run lint - Run ESLint
- npm run format - Format code with Prettier

License

MIT