12306mcp工具调用实战指南：从零开始掌握核心调用流程

1次阅读

共计 3020 个字符，预计需要花费 8 分钟才能阅读完成。

12306mcp 工具是中国铁路官方提供的接口调用工具，主要用于查询余票、车次信息、车站数据等铁路相关服务。它为开发者提供了标准化的数据接入方式，常见于票务系统、旅行类 App、企业内部订票工具等场景。通过这个工具，开发者可以避免自行抓取网页数据的复杂性和不稳定性。

在开始调用之前，需要确保你的开发环境满足以下基本要求：

操作系统：Windows/Linux/macOS 均可
网络环境：能够正常访问 12306 官网
开发语言环境：
Python 3.6+ 或 Java 8+
必要依赖库：
Python：requests、json、hashlib
Java：HttpClient、Jackson、Apache Commons Codec

12306mcp 采用 API Key 认证方式，每个开发者账号会分配唯一的密钥。调用时需要在请求头中加入认证信息：

Authorization: Bearer {your_api_key}

典型请求需要包含以下参数：

车次编号（train_no）
出发站代码（from_station）
到达站代码（to_station）
出发日期（depart_date）
座位类型（seat_type）

参数需要按照指定格式进行 URL 编码。

成功调用会返回 JSON 格式数据，包含以下主要字段：

status：请求状态
data：实际数据内容
message：附加信息

import requests
import json

# 基础配置
BASE_URL = "https://api.12306.cn/mcp"
API_KEY = "your_api_key_here"

# 构建请求头
headers = {"Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 构建请求参数
params = {
    "train_no": "G101",
    "from_station": "BJP",
    "to_station": "SHH",
    "depart_date": "2023-12-01",
    "seat_type": "二等座"
}

try:
    # 发送 GET 请求
    response = requests.get(f"{BASE_URL}/ticket/query",
        headers=headers,
        params=params
    )

    # 检查响应状态
    if response.status_code == 200:
        result = response.json()
        if result["status"] == "success":
            print("查询成功:")
            print(json.dumps(result["data"], indent=2, ensure_ascii=False))
        else:
            print(f"查询失败: {result['message']}")
    else:
        print(f"请求失败，状态码: {response.status_code}")

except Exception as e:
    print(f"发生异常: {str(e)}")

import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.fasterxml.jackson.databind.ObjectMapper;

public class MCPClient {
    private static final String BASE_URL = "https://api.12306.cn/mcp";
    private static final String API_KEY = "your_api_key_here";

    public static void main(String[] args) {HttpClient httpClient = HttpClients.createDefault();
        HttpGet request = new HttpGet(BASE_URL + "/ticket/query");

        // 设置请求头
        request.setHeader("Authorization", "Bearer" + API_KEY);
        request.setHeader("Content-Type", "application/json");

        // 设置请求参数
        request.setURI(request.getURI() + "?train_no=G101&from_station=BJP"
            + "&to_station=SHH&depart_date=2023-12-01&seat_type= 二等座");

        try {HttpResponse response = httpClient.execute(request);
            String responseBody = EntityUtils.toString(response.getEntity());

            ObjectMapper mapper = new ObjectMapper();
            JsonNode rootNode = mapper.readTree(responseBody);

            if (rootNode.path("status").asText().equals("success")) {System.out.println("查询成功:");
                System.out.println(rootNode.path("data").toString());
            } else {System.out.println("查询失败:" + rootNode.path("message").asText());
            }
        } catch (Exception e) {System.out.println("发生异常:" + e.getMessage());
        }
    }
}