AI导哈

IRCTC MCP 服务器

IRCTC MCP 服务器是一个远程 Model Context Protocol 服务，通过 RailKit REST API 提供印度铁路的列车搜索、座位余票、票价、PNR 状态和实时运行状态等信息查询能力，适用于 AI 助手和开发者集成。

  • by nayanraj210401
  • TypeScript
  • 混合部署
  • 2 星标
  • 更新于
在 GitHub 查看 nayanraj210401/irctc-mcp

使用说明

IRCTC MCP Server

A remote MCP server for Indian Railways, built on the RailKit REST API. It speaks Streamable HTTP at POST /mcp. You bring your own RailKit API key and send it with each request. The server holds no key of its own.

Tools

Tool What it returns
searchStations station codes for a name like "Delhi"
searchTrainsByName train numbers for a name like "Rajdhani"
getStation a station's name and coordinates
searchTrains trains between two stations, optionally on a date
checkSeatAvailability seat availability, fare, and waitlist prediction
getFare full fare breakdown
getTrainSchedule train details and full route
getLiveTrainStatus live running status for a journey date
getTrainHistory timeline of a completed journey
getLiveStation trains at a station in the next 2, 4 or 8 hours
getStationTimetable a station's timetable for today, yesterday or tomorrow
getCancelledTrains fully and partially cancelled trains
getPnrStatus PNR status, chart status, and passenger details

Dates are YYYY-MM-DD; the server converts them for RailKit.

Get a RailKit key

  1. Sign in at railkit.in.
  2. Open Dashboard, then API Keys, and create a key.

RailKit's docs say direct REST access requires the Advance plan, so expect Free and Pro keys to be rejected.

Connect

A public instance runs at https://irctc-mcp-production.up.railway.app/mcp. Use that as https://<host>/mcp below, or self-host. Send your key as Authorization: Bearer <key> or X-RailKit-Key: <key>.

Claude Code

claude mcp add --transport http irctc https://<host>/mcp --header "Authorization: Bearer <your-railkit-key>"

Cursor

In mcp.json (RAILKIT_API_KEY is an environment variable on your own machine):

{
  "mcpServers": {
    "irctc": {
      "url": "https://<host>/mcp",
      "headers": { "Authorization": "Bearer ${env:RAILKIT_API_KEY}" }
    }
  }
}

Windsurf

In mcp_config.json:

{
  "mcpServers": {
    "irctc": {
      "serverUrl": "https://<host>/mcp",
      "headers": { "Authorization": "Bearer <your-railkit-key>" }
    }
  }
}

claude.ai and Claude Desktop

Add a custom connector pointing at https://<host>/mcp.

TODO (maintainer): it is unverified how claude.ai sends a static API key to a custom connector. Test this and document the working setup, or add a supported auth flow.

Privacy

The server never stores or logs your key. Every request uses only the key sent with that request.

Self-host and develop

Requires Node 18+.

npm install
npm run dev          # watch mode on http://localhost:3000
npm test
npm run smoke:live   # live check against RailKit

Environment variables (see .env.example):

  • PORT: listen port (default 3000)
  • RAILKIT_BASE_URL: RailKit API base (default https://api.railkit.in)
  • ALLOWED_HOSTS: optional comma-separated Host header allowlist

The server does not read a RailKit key from the environment.

Health check: GET /health.

Docker

docker build -t irctc-mcp .
docker run -p 3000:3000 irctc-mcp

Railway

Deploy the repo on Railway. railway.json selects the Dockerfile and the /health check. Set ALLOWED_HOSTS to your public domain if you want Host header checking.

Older local version

The previous local stdio version lives on the backup/local-stdio branch.

Credits

If you use this project in your work, we'd appreciate a shoutout! While not required, it helps the project grow and helps others discover it. You can mention it like this:

IRCTC MCP - A Model Context Protocol server for Indian Railway IRCTC API integration
https://github.com/nayanraj210401/irctc-mcp

License

This project is licensed under the MIT License - see the LICENSE file for details.

相关 MCP