uniquename/mcp-bvg

BVG MCP Server

A Model Context Protocol (MCP) server for interacting with the BVG (Berlin Public Transport) API. This server provides tools to search for locations, plan journeys, get real-time departures/arrivals, and more.

Features

This MCP server provides the following tools:

Location Search

• bvg_locations_search: Search for stops, addresses, and points of interest
• bvg_locations_nearby: Find nearby stops and POIs by coordinates

Stop Information

• bvg_stop_details: Get detailed information about a specific stop
• bvg_stop_departures: Get upcoming departures at a stop
• bvg_stop_arrivals: Get upcoming arrivals at a stop

Journey Planning

• bvg_journey_plan: Plan journeys from A to B using public transport

Trip and Vehicle Information

• bvg_trip_details: Get detailed information about a specific trip
• bvg_radar: Find vehicles in a geographic area with movement data

Installation

1. Clone the repository:

git clone <repository-url>
cd mcp-bvg

2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

As an MCP Server

The server communicates via stdio and can be used with any MCP-compatible client.

npm start

Configuration for Claude Desktop

Add this to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "bvg-transport": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-bvg/build/index.js"]
    }
  }
}

Configuration for VS Code

This project includes VS Code configuration files in the .vscode directory:

• Tasks: Build, watch, start server, and test examples
• Launch configurations: Debug the MCP server and examples
• Settings: TypeScript and editor preferences
• MCP Config: Ready-to-use MCP server configuration

To use with VS Code:

1. Open the project folder in VS Code
2. Use Cmd+Shift+P → "Tasks: Run Task" to access build tasks
3. Use F5 to debug the MCP server
4. The MCP configuration is available in .vscode/mcp-config.json

Example Queries

Here are some example queries you can make:

Search for Locations

Search for "Alexanderplatz" in Berlin

Find Nearby Stops

Find stops near coordinates 52.5200,13.4050 (Brandenburg Gate)

Get Departures

Get the next departures from Alexanderplatz station

Plan a Journey

Plan a journey from Alexanderplatz to Potsdamer Platz

API Reference

The server uses the BVG REST API v6: https://v6.bvg.transport.rest/api.html

Development

Scripts

• npm run build: Compile TypeScript to JavaScript
• npm run dev: Watch mode for development
• npm start: Start the MCP server
• npm test: Run example tests
• npm run clean: Clean build directory

Project Structure

src/
├── index.ts              # Main MCP server
├── types/
│   └── bvg.ts           # TypeScript types for BVG API
├── utils/
│   └── api.ts           # HTTP client and utilities
└── tools/               # MCP tool implementations
    ├── locations.ts
    ├── nearby.ts
    ├── stops.ts
    ├── journeys.ts
    └── additional.ts

License

MIT License

MIT License