Files
higress/plugins/wasm-go/mcp-servers/mcp-train-ticket-query/README_ZH.md
2025-04-16 14:48:53 +08:00

51 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 火车票查询
API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi011240
## 什么是云市场API MCP服务
阿里云云市场是生态伙伴的交易服务平台我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。
云市场API依托Higress提供MCP服务您只需在云市场完成订阅并获取AppCode通过Higress MCP Server进行配置即可无缝集成云市场API服务。
## 如何在使用云市场API MCP服务
1. 进入API详情页订阅该API。您可以优先使用免费试用。
2. 前往云市场用户控制台使用阿里云账号登陆后查看已订阅API服务的AppCode并配置到Higress MCP Server的配置中。注意在阿里云市场订阅API服务后您将获得AppCode。对于您订阅的所有API服务此AppCode是相同的您只需使用这一个AppCode即可访问所有已订阅的API服务。
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度如您免费试用额度已用完您可以选择重新订阅。
# MCP服务器功能简介
本文档旨在介绍MCP服务器的主要功能及其配置的工具这些工具主要用于火车票信息查询服务。通过调用不同的API接口用户能够获取详细的列车时刻表、票价及座位信息等。
## 功能简介
`train-ticket-query` 服务器主要提供了三个针对不同需求场景设计的火车票查询服务。这包括余票查询、站站间行程查询以及特定车次的信息查询。每个工具都设计有特定参数来满足用户的查询需求,并返回结构化的数据结果,以便于进一步处理或展示给最终用户。此系统适用于需要集成火车票相关信息的应用程序开发者或者旅行规划平台。
## 工具简介
### 1. 余票查询接口
- **用途**:用于根据出发地、目的地和日期检索可用的列车班次及其详细信息。
- **使用场景**:当用户想要知道从一个城市到另一个城市的可选列车时,可以通过此接口快速获得所有符合条件的选项列表。
- **请求参数**
- `date`: 查询日期(必填)
- `end`: 目的地(必填)
- `start`: 出发地(必填)
### 2. 站站查询接口
- **用途**:提供基于出发点与终点之间的直接连接线路搜索功能,并允许指定是否仅考虑高速铁路选项。
- **使用场景**:适用于希望了解两地之间是否有直达列车或只关注高铁服务的情况。
- **请求参数**
- `date`: 查询日期
- `end`: 目的地(必填)
- `ishigh`: 是否仅显示高铁0表示否1表示是
- `start`: 出发地(必填)
### 3. 车次查询接口
- **用途**:允许用户输入具体的列车编号以获取该列车沿途停靠的所有站点详情。
- **使用场景**:对于已经确定乘坐哪一列火车但想了解更多关于途经站点信息的旅客非常有用。
- **请求参数**
- `date`: 查询日期
- `trainno`: 列车编号(必填)
以上就是对`train-ticket-query`服务器所提供功能的一个概述。每个工具都有其独特的应用场景,能够有效地帮助开发人员构建更加丰富且实用的交通出行相关应用。