transit-mcp — 이동비서 MCP (Korean Public Transit MCP Server)

A remote MCP (Model Context Protocol) server for Korean public transit. It helps an AI assistant answer not just "how do I get there?" but "what should I take right now, and what's my fallback if I miss it?" — combining route planning with real-time bus and subway arrivals.

Built for the Streamable HTTP transport with the official @modelcontextprotocol/sdk, stateless and container-ready.

Tools

Boarding-stop IDs from search_route chain directly into get_bus_arrival, so an assistant can go from "plan the route" to "is the next bus coming in time?" in one flow.

Related MCP server: Metro MCP

Endpoint

• Transport: Streamable HTTP (stateless)

• Path: POST /mcp

• Health check: GET /health

• Protocol version: 2025-03-26

Running locally

npm install
cp .env.example .env    # fill in the API keys
npm run build
npm start               # serves on :8080/mcp

Or in dev mode with reload:

npm run dev

Docker

docker build --platform linux/amd64 -t transit-mcp .
docker run --env-file .env -p 8080:8080 transit-mcp

Environment variables

Coverage & notes

• Route search covers the Seoul metropolitan area.

• Real-time bus data covers Gyeonggi Province stops (Seoul city buses are a planned addition via a nationwide bus API).

• Real-time subway data covers the entire Seoul metropolitan subway network.

• Tool responses are curated Korean text (not raw API dumps) to stay compact.

License

MIT