mcp-bvg

uniquename/mcp-bvg

3.2

If you are the rightful owner of mcp-bvg and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The BVG MCP Server is a Model Context Protocol server designed to interact with the Berlin Public Transport API, providing tools for location search, journey planning, and real-time transport information.

Tools
5
Resources
0
Prompts
0

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
  1. Install dependencies:
npm install
  1. 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