How joooook/12306-mcp works
12306-mcp exposes 12306 ticket-search capabilities as MCP tools and a station-data resource, over stdio or HTTP. The main workflow is an MCP client request routed to a search tool, which resolves station codes, queries 12306 and returns formatted/filtered results; the README also documents filtering, route-stop queries and transfer searches. Most runtime behavior is concentrated in src/index.ts, so several distinct responsibilities share that path. The excerpt shows only selected implementation sections; documented but unsampled features are represented without guessing their internal calls.
Main entry points: index.ts Search tools · types.ts Ticket models
Components 13
MCP access
- stdio transport
src/index.ts - HTTP transport
src/index.ts - MCP server
src/index.ts
Ticket search
- Search tools
src/index.ts - Date utility
src/index.ts - Ticket search
src/index.ts - Result filtering
src/index.ts - Transfer search
src/index.ts - Route-stop query
src/index.ts
Rail data
- Station data
src/index.ts - Ticket models
src/types.ts
12306 integration
- 12306 services
Other components
- MCP client
Connections 17
- MCP client → stdio transport: uses
README.md - MCP client → HTTP transport: uses
README.md - stdio transport → MCP server: connects
src/index.ts - HTTP transport → MCP server: starts server
src/index.ts - MCP server → Search tools: registers
src/index.ts - Search tools → Date utility: provides
src/index.ts - Search tools → Ticket search: provides
README.md - Search tools → Transfer search: provides
README.md - Search tools → Route-stop query: provides
README.md - Ticket search → Station data: resolves stations
src/index.ts - Ticket search → 12306 services: queries
src/index.ts - Ticket search → Result filtering: filters results
src/index.ts - Transfer search → 12306 services: queries
src/index.ts - Transfer search → Result filtering: filters results
src/index.ts - Ticket search → Ticket models: uses models
src/index.ts - Transfer search → Ticket models: uses models
src/index.ts - Station data → 12306 services: loads data