Skip to main content
Glama
indian-rail-mcp

indian-rail-mcp

by mahi-v-v

indian-rail-mcp

インド鉄道のデータを公式ソースから取得する、型付きTypeScriptライブラリおよびMCPサーバー。

APIキー不要。サードパーティのデータベンダー不要。消えてしまうnpm中間業者も不要。

NTES — enquiry.indianrail.gov.in

列車時刻表、リアルタイム運行情報、編成位置、駅間列車検索、ライブ駅掲示板

IRCTC — www.irctc.co.in

PNRステータス、車両別・座席レベルの空席情報


存在理由

人気のあったirctc-connectパッケージは非推奨となりました。作者はこれをrailkitに改名し、サインアップとAPIキーの背後に移しました。また、依存していた無料バックエンド(bookmytrain.vercel.app、easy-rail.onrender.com)は現在404と500を返します。そのエコシステムでまだ動作しているものは、サードパーティサイトのマークアップから取得した認証情報を使って、そのサイトをスクレイピングするものばかりです。

このライブラリは、インド鉄道が実際に運営しているソースに直接アクセスします。


Related MCP server: Indian Railway MCP

インストール

npm install indian-rail-mcp

Node 20+が必要です。実行時依存はcheerioのみです。

ライブラリ

import {
  getTrainInfo,
  trackTrain,
  searchTrainsBetweenStations,
  getLiveStation,
  getSeatAvailability,
  checkPnrStatus
} from "indian-rail-mcp";

// Full schedule and route
const info = await getTrainInfo("12951");
// -> { trainName: "NDLS TEJAS RAJ", type: "RAJDHANI", runsOn: "Daily",
//      classes: ["1A","2A","3A"], route: [ { stationCode: "MMCT", departure: "17:00", ... }, ... ] }

// Where is it right now (defaults to the journey in progress)
const live = await trackTrain("12626");
// -> { journeyDate, summary: "Arrived at BUTI BORI(BTBR) at 13:27 26-Aug",
//      stops: [...], coachPosition: [ { position: 0, coach: "ENG", classCode: "ENG" }, ... ] }

// Direct trains between two stations — code or full name
await searchTrainsBetweenStations("CAN", "PAY");
await searchTrainsBetweenStations("NEW DELHI", "MMCT");

// Next couple of hours at a station, with delay and platform
await getLiveStation("NDLS");

// Reservation chart: per-coach vacancy, plus berth detail when a class is given
await getSeatAvailability({ trainNumber: "12951", boardingStation: "MMCT", travelClass: "3A" });

駅はコードまたは正式名称のどちらでも受け付けます — NDLSもNEW DELHIも動作し、NTES独自の8,700駅カタログに対して解決されます。日付はDD-MM-YYYY、DD-MMM-YYYY、YYYY-MM-DDのいずれかを受け付けます。

エラー

すべての失敗は型付きのRailErrorです:

クラス

code

意味

InvalidInputError

INVALID_INPUT

不正な駅・列車番号・日付 — ネットワーク呼び出し前にローカルで検出

NtesError

NTES_ERROR

NTESがERR<nnn>ページを返した

IrctcError

IRCTC_ERROR

IRCTCがerrorMessageを返した

UpstreamError

UPSTREAM_ERROR

ネットワーク障害または解析不能なレスポンス

ERR000について: NTESは、不正な入力に対しても実際の障害に対しても同じ汎用のERR000ページを返します。そのため、このライブラリはNTESを呼び出す前に駅コードをカタログに対して検証し、自分のタイプミスが「鉄道サービスが停止しています」と報告されることは決してありません。NtesErrorは、障害であると断定するのではなく、両方の可能性を意図的に示しています。

MCPサーバー

6つのツール:getTrainInfo、trackTrain、searchTrainBetweenStations、getLiveStation、getSeatAvailability、checkPnrStatus。

import { createRailMcpServer } from "indian-rail-mcp/mcp";

const server = createRailMcpServer({ allowPnr: true });
await server.connect(yourTransport);

Vercelへのデプロイ

vercel deploy

vercel.jsonは関数を**bom1(ムンバイ)**に固定します — 両方のアップストリームがインドにあり、これは見た目以上に価値があります:ウォームリクエストは約124msで実行されるのに対し、コールドでは約885msです。また、インドのegress IPからのインド向けトラフィックは、NTESの前にあるF5 WAFをトリップする可能性がはるかに低くなります。

環境変数:

変数

目的

RAIL_API_KEY

checkPnrStatusを有効にするために必須。呼び出し側はx-api-keyとして送信します。

RATE_LIMIT_PER_MINUTE

IPごとのリクエスト上限。デフォルト30。

任意のMCPクライアントをStreamable HTTPトランスポートを使用してhttps://<your-deployment>/api/mcpに向けます。


PNRと個人データ

checkPnrStatusは乗客の個人データ — 氏名、年齢、性別、車両、座席 — を返します。

  • RAIL_API_KEYが設定され一致しない限り無効です。フェイルクローズドです。

  • ライブラリはPNRレスポンスをログ記録、キャッシュ、永続化することは一切ありません。

  • 意図的にバッチ処理や列挙のヘルパーはありません。設計上、1回の呼び出しにつき1つのPNRです。

これを公開デプロイする場合は、その状態を維持してください。PNRスクレイパーを構築しないでください。


データソースと規約

すべてのデータはIndian Railwaysの所有物であり、**Centre for Railway Information Systems (CRIS)**によって提供されています。このプロジェクトはIndian Railways、CRIS、IRCTCとは提携・承認・支援関係にありません。

デプロイ前にこれを読んでください:

  • NTES利用規約は、抽出データのダウンロードを個人利用に限り許可しており、事前の書面による許可なしに「いかなるソフトウェアプログラム」を使用してサイトから体系的にデータベースを構築したり、そのページを「公的または私的な電子検索システムまたはサービス」に含めたりしてはならないと規定しています。また、鉄道データは「商業目的に使用すべきではない」とも規定しています。

  • CRISはリクエストに応じてその許可を与えます:「本ウェブサイトに掲載されている資料は、メールを送信して適切な許可を得た上で、無料で複製することができます。」 送信準備が整ったリクエストはPERMISSION-REQUEST.mdにあります。

  • このプロジェクトの許可ステータス:リクエスト済み、保留中。

  • IRCTCの規約はより厳格であり、PNRデータは個人データです。

データの正確性はベストエフォートであり、保証されません — NTES自身の免責事項も同じことを述べています。安全に関わる用途には依存せず、鉄道会社に直接確認してください。

良き市民でありましょう:デフォルト設定は安定したものをキャッシュし、IPごとにレート制限し、単一のアップストリームセッションを再利用します。これらを削除しないでください。


開発

npm install
npm test          # parser regression tests against recorded fixtures — no network
npm run smoke     # live end-to-end check against NTES and IRCTC
npm run test:mcp  # drives the MCP handler locally: handshake, tools, auth, rate limit
npm run fixtures  # re-record fixtures when upstream markup changes
npm run build

test/fixtures/内のフィクスチャは記録されたHTML/JSONです。CRISがマークアップを変更すると、ツールが静かに空の結果を返す代わりに、npm testが特定のアサーションで失敗します。

ライセンス

MIT — LICENSEを参照してください。ライセンスはこのソースコードのみを対象としており、基盤となる鉄道データは対象外です。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time Indian Railways information retrieval, including live train running status, station schedules, and upcoming arrivals/departures.
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables checking railway seat availability, berth types, and pricing for Indian trains through natural language queries.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to query real-time Indian Railways data including train schedules, live status, PNR status, seat availability, fares, and coach positions via the Model Context Protocol.
      -