# 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:
```bash
git clone <repository-url>
cd mcp-bvg
```
2. Install dependencies:
```bash
npm install
```
3. Build the project:
```bash
npm run build
```
## Usage
### As an MCP Server
The server communicates via stdio and can be used with any MCP-compatible client.
```bash
npm start
```
### Configuration for Claude Desktop
Add this to your Claude Desktop configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"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
