这是一个基于 Model Context Protocol (MCP) 开发的服务器实现,旨在通过标准化的接口向 LLM 客户端提供特定的外部功能。

项目简介

该项目是一个非官方的同程旅行 MCP Server,目前主要支持对接同程旅行网站的火车票查询接口。它使用 MCP Typescript SDK 开发,提供 Node.js 环境下的运行支持,未来可能提供 Java 版本。

主要功能点

本项目提供两个核心工具供 LLM 调用:

  1. 火车票查询工具: 查询指定日期、出发地和目的地之间的火车票信息,包括车次列表、时间、票价和余票等详细数据。
  2. 系统时间查询工具: 获取当前服务器的系统日期和时间,格式为 'yyyy-MM-dd hh:mm:ss'。

安装步骤

  1. 安装 Node.js: 请确保你的系统已安装 Node.js。可以从 Node.js 官方网站 下载并安装。
  2. 下载项目代码: 从 GitHub 克隆或下载本项目代码。
  3. 安装依赖: 在项目根目录下打开终端,运行以下命令安装所需的依赖:
    npm install

服务器配置 (适用于 MCP 客户端)

MCP 服务器是供 MCP 客户端使用的。要在 MCP 客户端中集成此服务器,你需要配置客户端,告知其如何启动并连接到此服务器。配置信息通常包含服务器名称 (name)、启动命令 (command) 和参数 (args)。

根据本项目的实现,你可以使用 'npx' 来启动服务器。配置时需要指定:

  • 'name': 服务器的唯一名称,例如 'tongchenglvxing-mcp-server'。
  • 'command': 通常设置为 'npx'。
  • 'args': 启动脚本的参数列表。这取决于你是从本地代码运行还是使用已发布的 npm 包。
    • 从本地代码运行: 参数应指向项目构建后的入口文件,例如 '["-y", "/你的项目路径/tongchenglvxing-mcp-server/dist/index.js"]'。请将 '/你的项目路径' 替换为项目实际所在的路径。
    • 使用已发布的 npm 包: 参数应指向已发布的包名,例如 '["-y", "@wuchubuzai/tongchenglvxing-mcp-server"]'。请注意,此配置需要该 npm 包已发布并可安装。

基本使用方法

作为 MCP 服务器,它本身不提供用户界面。你需要一个支持 MCP 协议的 LLM 客户端来与之交互。

  1. 配置客户端: 在你的 MCP 客户端中,按照上述“服务器配置”说明添加此服务器的配置信息。
  2. 启动客户端: 启动你的 MCP 客户端。客户端会根据配置信息尝试启动或连接此 MCP 服务器。
  3. 通过客户端调用工具: 在 LLM 客户端的对话或交互界面中,你可以通过提问来触发 LLM 调用此服务器提供的工具。例如,你可以问 LLM:“查询一下从北京到上海 2025-05-01 的火车票”,如果 LLM 识别出这是一个需要使用“火车票查询工具”的任务,并且客户端已连接到此 MCP 服务器,LLM 便会通过 MCP 协议向服务器发送调用请求,服务器执行查询并将结果返回给客户端,最终呈现给用户。同样,询问当前时间可能会触发“系统时间查询工具”。

请注意,与外部接口(如同程旅行)的交互可能受网络、反爬机制等因素影响。

信息

分类

网页与API