返回市场
irctc-MCP服务器

irctc-MCP服务器

作者:nayanraj2104012 星标更新:2025-05-20

项目介绍

IRCTC MCP 服务器

这是一个用于印度铁路(IRCTC)集成的模型上下文协议(MCP)服务器,使用RapidAPI。此服务器提供了搜索列车、检查PNR状态和其他与IRCTC相关的功能工具。

功能

  • 在车站之间搜索列车
  • 检查座位可用性
  • 获取列车时刻表
  • 检查PNR状态
  • 获取实时列车状态
  • 使用TypeScript构建以确保类型安全
  • 基于环境的配置

预备条件

  • Node.js 18+
  • npm 或 yarn
  • IRCTC API 的RapidAPI密钥

设置

  1. 克隆仓库:

    git clone <repository-url>
    cd irctc-mcp
    
  2. 安装依赖项:

    npm install
    
  3. 复制.env.example.env并用你的RapidAPI密钥更新:

    cp .env.example .env
    
  4. 构建项目:

    npm run build
    

运行服务器

开发模式

npm run dev

生产模式

npm run build
npm start

在您的应用程序中使用MCP

添加到Cascade

要将IRCTC MCP添加到Cascade,您需要更新位于~/.codeium/windsurf/mcp_config.json的MCP配置文件:

{
  "mcpServers": {
    "irctc": {
      "command": "node",
      "args": [
        "/path/to/irctc-mcp/dist/index.js"
      ],
      "env": {
        "RAPIDAPI_KEY": "your_rapidapi_key_here",
        "RAPIDAPI_HOST": "irctc1.p.rapidapi.com"
      }
    }
  }
}

/path/to/irctc-mcp替换为您项目的实际路径,并用您的实际API密钥更新RAPIDAPI_KEY

添加到Claude或其他兼容MCP的应用程序

您可以通过创建一个JSON配置文件来将此MCP添加到Claude或其他兼容MCP的应用程序:

{
  "name": "IRCTC MCP",
  "description": "用于与RapidAPI集成的IRCTC MCP服务器",
  "transport": {
    "type": "http",
    "url": "http://localhost:3000"
  }
}

添加到Claude桌面版

macOS:

  1. 打开Claude桌面版
  2. 单击菜单栏中的"Claude"
  3. 选择"设置"(或"偏好设置")
  4. 转到"开发者"标签页
  5. 单击"编辑配置"
    • 这将打开配置文件:~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

  1. 打开Claude桌面版
  2. 单击左上角的汉堡菜单(☰)
  3. 转到"文件" > "设置"
  4. 导航到"开发者"标签页
  5. 单击"编辑配置"
    • 这将打开配置文件:%APPDATA%\Claude\claude_desktop_config.json

配置示例:

在您的Claude桌面版配置文件中添加以下JSON:

{
  "mcpServers": {
    "irctc": {
      "command": "node",
      "args": [
        "/path/to/irctc-mcp/dist/index.js"
      ],
      "env": {
        "RAPIDAPI_KEY": "your_rapidapi_key_here",
        "RAPIDAPI_HOST": "irctc1.p.rapidapi.com"
      }
    }
  }
}

完成更改后,请完全关闭并重新启动Claude桌面版以使更改生效。

添加到Claude网络版

  1. 将上述JSON配置保存到文件中(例如,irctc-mcp.json
  2. 在Claude网络版中,点击侧边栏的"+"按钮
  3. 选择"添加MCP服务器"并上传您的JSON配置文件
  4. 现在,IRCTC MCP将在您的Claude对话中可用

在Claude中的示例用法

连接后,您可以请求Claude使用IRCTC MCP进行如下提示:

你能查找从NDLS到PNBE的2023年12月25日的列车吗?

或者:

检查PNR状态1234567890

可用工具

列车工具

  • searchTrains: 在两个车站之间搜索列车
  • checkSeatAvailability: 检查特定列车的座位可用性
  • getTrainSchedule: 获取列车的完整时刻表
  • getLiveTrainStatus: 获取正在运行的列车的实时状态

PNR工具

  • getPnrStatus: 获取PNR的当前状态
  • getPnrHistory: 获取PNR的预订历史(占位符)
  • checkPnrChartStatus: 检查PNR是否已准备就绪

RapidAPI集成

本项目使用了RapidAPI上的IRCTC API。要使用此API:

  1. RapidAPI注册免费账户
  2. 订阅IRCTC API
  3. 从RapidAPI仪表板获取您的API密钥

环境变量

  • RAPIDAPI_KEY: 您的RapidAPI密钥(必需)
  • RAPIDAPI_HOST: 设置为irctc1.p.rapidapi.com
  • PORT: 服务器端口(默认:3000)
  • NODE_ENV: 环境(开发/生产)

致谢

如果您在工作中使用了这个项目,我们非常感谢您的提及!虽然这不是必须的,但有助于项目的发展和让更多人发现它。您可以这样提及:

IRCTC MCP - 用于印度铁路IRCTC API集成的模型上下文协议服务器
https://github.com/nayanraj210401/irctc-mcp

许可证

本项目根据MIT许可证授权 - 查看LICENSE文件以获取详细信息。 </中文翻译>