DM

drfccv/mcp-server-12306

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

415 stars 59 forks Качество 82 Тренд 28MIT

Сервер 12306 MCP — это высокопроизводительная система запроса билетов на поезд, основанная на протоколе Model Context Protocol (MCP). Он предоставляет официальную службу передачи данных в реальном времени 12306 через стандартизированные интерфейсы, включая основные функции, такие как запросы доступности билетов, информация о станциях, остановки поездов и решения для пересадки.

Обзор

MCP Server 12306 — это высокопроизводительный сервис для запроса билетов на поезд, основанный на протоколе Model Context Protocol (MCP). Он поддерживает официальную доступность билетов 12306, цены на билеты, станции, остановки, запросы на пересадку и интеллектуальные инструменты для определения времени. Он совместим с ИИ, автоматизацией и сценариями интеллектуального помощника, готовый к использованию с самого производства. - Поиск оставшихся билетов/номеров поездов/мест/времени/пересадки в режиме реального времени в реальном времени - Национальное управление информацией о станциях и нечеткое поиск, поддерживает китайский, пиньинь, упрощённый пиньинь и трёхсимвольные коды - Полная поддержка официальных остановок и решений по пересадке - Информация о тарифах в реальном времени для каждого поезда - Интеллектуальный инструмент с поддержкой часовых поясов и отметок времени - Двойные режимы передачи: Stdio (рекомендуется Claude Desktop) | Потоковый HTTP (удалённое развертывание) - стандарт MCP 2025-03-26, plug-and-play для сценариев ИИ/автоматизации Этот проект поддерживает два режима выполнения: 1. : Подходит для локальных MCP-клиентов, таких как Claude Desktop (рекомендуется). 2. : Подходит для удалённого развертывания или доступа через SSE/POST. В этом режиме MCP-сервер взаимодействует с клиентами через стандартный ввод/вывод, не занимая сетевые порты. В этом режиме сервер запускает веб-сервис (порт по умолчанию 8000), поддерживающий взаимодействие MCP SSE и POST. Все подробные функции, реализации и методы использования основных инструментов процессов для этого проекта включены в каталог /docs: Каждый документ включает: - Описание инструмента - Методы реализации - Параметры запроса и примеры возврата - Типичные шаблоны вызовов - Этот проект предназначен только для обучения, исследований и технического обмена; любое коммерческое использование строго запрещено. - Этот проект не хранит, не изменяет и не распространяет официальные данные 12306; он служит только интеллектуальной агрегацией и пересылкой официальных публичных интерфейсов. - Любые последствия, возникающие от использования этого проекта (включая, но не ограничиваясь, блокировкой аккаунтов, аномалиями данных, юридическими рисками и т.д.) являются ответственностью пользователя; автор проекта не несёт ответственности. - Пожалуйста, соблюдайте китайские законы и нормативные акты и официальные правила 12306, и используйте их разумно и в соответствии с требованиями.

Обзор (машинный перевод)

Сервис запроса билетов на поезд 12306 на основе модельного протокола контекста (MCP)

Поддерживает шесть основных функций запроса: оставшийся билет / тариф / станция / остановка / пересадка / время, готов к использованию с коробки, подходит для AI-ассистентов, автоматизированных скриптов, умных терминалов и других сценариев.


📑 Содержание

  • ✨ Функциональные характеристики
  • 🚀 Начинайте быстро
  • Экологические требования
  • Метод 1: Режим Stdio (рекомендуется для местных клиентов)
  • Метод 2: Потоковый HTTP-режим (удалённое развертывание)
  • Метод 3: Развертывание Docker
  • 🛠️ Обзор инструментов
  • ⚙️ Элемент конфигурации
  • 🏗️ Структура проекта
  • 🧑 💻 Руководство по развитию
  • 📚 Подробная документация
  • ⚠️ Отказ от ответственности
  • 📄 Лицензия

✨ Функциональные особенности

Категория Способность
🎫 Запрос по оставшимся билетам Поиск оставшихся билетов / номера поезда / места / времени на всех остановках, поддерживает фильтрацию по номеру поезда
💰 Вопрос о стоимости билетов Просмотр тарифов в реальном времени для каждого типа поезда и места (бизнес-класс → без места, полное покрытие)
🏙️ Поиск по станциям 3 382+ станции по всей стране, поддерживает китайский / пиньинь / упрощённый пиньинь / трёхсимвольный кодовый поиск
🔄 Передача в транзите Официальный план передачи автоматически пагинирует и фиксирует маршрут, возвращая полный маршрут и время ожидания
🛤️ Вопрос о остановке Проверьте все остановки, а также время прибытия и отправления назначенных поездов
🕐 Инструмент времени Получает текущее время и относительную дату для любого часового пояса, помогая выбрать даты путешествия
🔌 Режим двойной передачи Stdio (локальный) | Потоковый HTTP (удалённый), общий базовый экземпляр
🔄 Автоматическое согласование протокола Основано на MCP SDK v2, автоматически совместимо с эпохой Handshake Era (2025-11-25) и современными протоколами (2026-07-28)

🚀 Начинай быстро

Экологические требования

Зависим Запрос
Python >= 3.10, 💡 推荐使用 uv’: Изоляция среды, быстрая установка, версия зависимостей управления файлами.

Метод 1: Режим Stdio (рекомендуется локальный клиент)

MCP Server взаимодействует с клиентами через стандартный ввод/вывод, не занимает сетевые порты и подходит для локальных MCP-клиентов, таких как Claude Desktop и Cursor.

Установка:

Конфигурация клиента (например, claude_desktop_config.json):

Другие методы установки (нажмите для расширения)

pipx:

Локальный исходный код (отладка разработчика):

Метод 2: Потоковый HTTP-режим (удалённое развертывание)

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

Установка

uvx mcp-server-12306
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "12306": { "command": "uvx", "args": ["mcp-server-12306"] } } }