MCP National Rail

1[![smithery badge](https://smithery.ai/badge/@lucygoodchild/mcp-national-rail)](https://smithery.ai/server/@lucygoodchild/mcp-national-rail)
2 
3# mcp-national-rail
4 
5A Model Context Protocol (MCP) server to retrieve train schedules from National Rail.
6 
7## Overview
8 
9This project implements a server using the Model Context Protocol (MCP) that allows AI agents to retrieve train information on National Rail trains using the Realtime Trains API. 
10 
11It provides tools for:
12- get_live_departures
13- get_live_arrivals
14- get_departures_by_date
15- get_arrivals_by_date
16 
17## Installation
18 
19Real Time Trains API account can be created from here: https://api.rtt.io/ 
20 
21You will need to note down your API Auth credentials 
22 
23### Installing via Smithery
24 
25To install mcp-national-rail for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@lucygoodchild/mcp-national-rail):
26 
27```bash
28npx -y @smithery/cli install @lucygoodchild/mcp-national-rail --client claude
29```
30 
31### Manual Installation for Claude Desktop
32 
33#### Prerequisites
34- Node.js
35 
36#### Setup
37 
381. Clone this repository
392. Install dependencies
40```bash
41npm install
42```
433. Build and start the project
44```bash
45npm run build
46npm run start
47```
484. Add the following to your MCP client configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
49```bash
50{
51  "mcpServers": {
52    "mcp-national-rail": {
53      "command": "node",
54      "args": ["/path/to/mcp-national-rail/dist/index.js"],
55      "env": {
56        "RTT_API_USERNAME": "your_rtt_api_username",
57        "RTT_API_PASSWORD": "your_rtt_api_password"
58      }
59    }
60  }
61}
62```
63Make sure to replace "/path/to/mcp-national-rail/dist/index.js" with the actual path and add your RTT API username and password which can be created from here: https://api.rtt.io/
64 
655. Restart Claude
66 
67### Development
68- Create .env file based on the example file
69```bash
70RTT_API_USERNAME=your_rtt_api_username
71RTT_API_PASSWORD=your_rtt_api_password
72```
73 
74Run the inspector with the following command:
75```bash
76npx @modelcontextprotocol/inspector node dist/index.js
77```
78