Synchro Bus MCP Server

🚀 Synchronous Bus MCP Server

This is a Model Context Protocol (MCP) server for accessing the Instant-System API. It provides access to multiple endpoints of the Instant-System API v3, specifically for the Synchro Bus network with ID 3.

🚀 Quick Start

This MCP server is designed to facilitate access to the Instant-System API v3 for the Synchro Bus network.

✨ Features

The server exposes the following API endpoints:

• networkGet: Retrieve network information.
• linesGet: Fetch all lines in the network.
• lineGet: Obtain detailed information about a specific line.
• lineStopAreasGet: Get all stop areas for a specific line.
• lineStopAreaSchedulesGet: Retrieve the schedules of a line within a specific stop area.
• disruptionsGet: Get the current disruptions in the network.
• vehicleJourneysDirectionsGet: Obtain the directions of vehicle journeys for a specific line.

📦 Installation

1. Clone the repository.
2. Install dependencies:

   npm install
   

3. Copy the example environment file and update the settings:

   cp .env.example .env
   

4. Build the project:

   npm run build
   

📚 Documentation

Configuration

Create a .env file in the root directory and add the following variable:

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

Usage

Start the server:

npm start

Use the development mode (with auto-reload):

npm run dev

API Reference

networkGet

Retrieve information about the Synchro Bus network.

linesGet

Fetch all lines in the network.

lineGet

Obtain detailed information about a specific line.

lineStopAreasGet

Get all stop areas for a specific line.

lineStopAreaSchedulesGet

Retrieve the schedules of a line within a specific stop area.

disruptionsGet

Get the current disruptions in the network.

vehicleJourneysDirectionsGet

Obtain the directions of vehicle journeys for a specific 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 the code using Prettier.

📄 License

MIT