caltrain-mcp

Name: caltrain-mcp
Author: davidyen1124

@davidyen1124

关于 caltrain-mcp

A Model Context Protocol (MCP) server for Caltrain schedules. Get real-time train departures using GTFS data, designed for Claude Desktop and other MCP clients.

#caltrain #mcp #train-schedules

基本信息

分类

生产力

许可证

NOASSERTION

运行时

python

传输方式

stdio

发布者

davidyen1124

提交者

David

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "caltrain": {
      "command": "uvx",
      "args": [
        "caltrain-mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is caltrain-mcp?

caltrain-mcp is a Model Context Protocol server that provides Caltrain schedule information using official GTFS data. It is intended for users of MCP-compatible clients (like Claude Desktop) who need to look up train departures, stations, and travel times between any two Caltrain stops.

How to use caltrain-mcp?

Configure caltrain-mcp in your MCP client (e.g., Claude Desktop) by adding "caltrain": { "command": "uvx", "args": ["caltrain-mcp"] } to the MCP configuration file. The server can also be tested directly via Python imports or started with uvx caltrain-mcp. It relies on local GTFS data that must be fetched first by running fetch_gtfs.py.

Key features of caltrain-mcp

Real‑time (GTFS‑based) train schedules between any two stations
Look up all 31 Caltrain stations by full name, short name, or abbreviation
Query departures at a specific time using the when_iso parameter
Smart partial matching of station names (e.g., "diridon" matches "San Jose Diridon")
Supports weekday/weekend service calendars from official GTFS data

Use cases of caltrain-mcp

Ask your AI assistant for the next trains from San Jose Diridon to San Francisco
Find all available Caltrain stations without memorizing names
Plan a commute at a precise time and date, using GTFS data
Get departure times for the Gilroy extension line

FAQ from caltrain-mcp

What GTFS data does caltrain-mcp use?

It uses official Caltrain GTFS data, including stops.txt, trips.txt, stop_times.txt, and calendar.txt, which are downloaded by running fetch_gtfs.py.

How do I install and run caltrain-mcp?

Install the uv package manager, run uv sync to install dependencies, then download the GTFS data with uv run python scripts/fetch_gtfs.py. Finally, configure your MCP client to run uvx caltrain-mcp.

What tools does caltrain-mcp expose?

It exposes two tools: next_trains(origin, destination, when_iso=None) to get upcoming departures, and list_stations() to list all 31 Caltrain stations.

How does caltrain-mcp communicate?

The server communicates via stdin/stdout using the Model Context Protocol (MCP). It does nothing when run directly in a terminal.

Are there any known limitations?

The README notes that actual arrival times may vary and that the server relies on the official GTFS data, so accuracy depends on that data. It handles mixed integer/string GTFS fields and supports 24+ hour time format.