get-station-code-by-names

Find station codes for Chinese railway stations by entering their Chinese names. Use this tool to get the required station_code parameter when booking tickets through 12306.

Instructions

通过具体的中文车站名查询其 station_code 和车站名。此接口主要用于在用户提供具体车站名作为出发地或到达地时，为接口准备 station_code 参数。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`stationNames`	Yes	具体的中文车站名称，例如："北京南", "上海虹桥"。若要查询多个站点，请用\|分割，比如"北京南\|上海虹桥"。

Implementation Reference

src/index.ts:644-659 (handler)

The handler function processes one or more Chinese station names (split by '|'), optionally strips trailing '站', looks them up in the NAME_STATIONS dictionary, and returns a JSON object with station codes or error messages.

async ({ stationNames }) => {
  let result: Record<string, object> = {};
  for (let stationName of stationNames.split('|')) {
    stationName = stationName.endsWith('站')
      ? stationName.substring(0, -1)
      : stationName;
    if (!(stationName in NAME_STATIONS)) {
      result[stationName] = { error: '未检索到城市。' };
    } else {
      result[stationName] = NAME_STATIONS[stationName];
    }
  }
  return {
    content: [{ type: 'text', text: JSON.stringify(result) }],
  };
}

src/index.ts:637-643 (schema)

Zod input schema defining 'stationNames' as a string parameter with description for querying station codes by Chinese names.

{
  stationNames: z
    .string()
    .describe(
      '具体的中文车站名称，例如："北京南", "上海虹桥"。若要查询多个站点，请用|分割，比如"北京南|上海虹桥"。'
    ),
},

src/index.ts:634-660 (registration)

Registers the 'get-station-code-by-names' tool on the MCP server, including name, description, input schema, and handler function.

server.tool(
  'get-station-code-by-names',
  '通过具体的中文车站名查询其 `station_code` 和车站名。此接口主要用于在用户提供**具体车站名**作为出发地或到达地时，为接口准备 `station_code` 参数。',
  {
    stationNames: z
      .string()
      .describe(
        '具体的中文车站名称，例如："北京南", "上海虹桥"。若要查询多个站点，请用|分割，比如"北京南|上海虹桥"。'
      ),
  },
  async ({ stationNames }) => {
    let result: Record<string, object> = {};
    for (let stationName of stationNames.split('|')) {
      stationName = stationName.endsWith('站')
        ? stationName.substring(0, -1)
        : stationName;
      if (!(stationName in NAME_STATIONS)) {
        result[stationName] = { error: '未检索到城市。' };
      } else {
        result[stationName] = NAME_STATIONS[stationName];
      }
    }
    return {
      content: [{ type: 'text', text: JSON.stringify(result) }],
    };
  }
);

12306-MCP