How dkawale499/railway-mcp-server works
This is a Spring Boot MCP adapter that exposes Railway Reservation backend operations as tools for Copilot and other MCP clients. The main workflow is MCP tool invocation, domain-specific tool delegation, authenticated HTTP request, and backend response. Authentication maintains a shared active account and refreshes a cached JWT after a 401; passenger booking and lookup, wallet access, and administrator reporting and schedule management are separate capabilities. The excerpts show the tool-to-client calls and client HTTP behavior; README documents the Streamable HTTP entry point and additional capabilities.
Main entry points: RailwayApiClient.java Railway API client · RailwayTools.java Railway tools · RailwayApiConfiguration.java Tool registration · CoachConfig.java Coach configuration
Components 12
MCP entry
- Tool registration
src/main/java/com/sts/Railway_mcp_server/config/RailwayApiConfiguration.java - Railway tools
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java
Passenger tools
- Account tools
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Travel tools
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Wallet and tickets
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java
Administration
- Ticket and user admin
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Schedule admin
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Coach configuration
src/main/java/com/sts/Railway_mcp_server/tools/CoachConfig.java
Backend access
- Railway API client
src/main/java/com/sts/Railway_mcp_server/service/RailwayApiClient.java - API settings
src/main/java/com/sts/Railway_mcp_server/config/RailwayApiProperties.java
Other components
- MCP client
- Railway Reservation API
Connections 11
- MCP client → Railway tools: invokes tools
README.md - Tool registration → Railway tools: registers callbacks
src/main/java/com/sts/Railway_mcp_server/config/RailwayApiConfiguration.java - Railway tools → Account tools: exposes
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Account tools → Railway API client: delegates auth
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Travel tools → Railway API client: delegates travel
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Wallet and tickets → Railway API client: delegates account
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Ticket and user admin → Railway API client: delegates reports
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Schedule admin → Railway API client: delegates schedules
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Schedule admin → Coach configuration: accepts typed coaches
src/main/java/com/sts/Railway_mcp_server/tools/RailwayTools.java - Railway API client → API settings: reads settings
src/main/java/com/sts/Railway_mcp_server/service/RailwayApiClient.java - Railway API client → Railway Reservation API: sends HTTP requests
src/main/java/com/sts/Railway_mcp_server/service/RailwayApiClient.java