Skip to main content
Glama
transport12 MCP Server

transport12 MCP Server

by yasg1988

transport12-mcp

transport12 MCP

npm version npm downloads license Node.js MCP

MCP-сервер для HTTP API transport12.

Сервер не обращается напрямую к внешним транспортным источникам. Все данные берутся через API основного сервиса transport12.

Меню

Related MCP server: mcp-stm-montevideo

Быстрый старт

Локальный запуск через npm:

TRANSPORT12_API_BASE_URL=https://your-transport12-api.example npx -y transport12-mcp

Готовый удаленный MCP endpoint:

https://transport12.yasg.ru/mcp

Если AI-клиент поддерживает удаленный MCP, достаточно указать этот URL как Streamable HTTP MCP server.

Варианты подключения

1. Локальный MCP

AI-клиент запускает пакет у пользователя на компьютере или на его сервере.

npx -y transport12-mcp

Минимальная переменная окружения:

TRANSPORT12_API_BASE_URL=https://your-transport12-api.example

2. Удаленный MCP

Можно использовать готовый endpoint:

https://transport12.yasg.ru/mcp

Или поднять свой HTTP-сервис:

MCP_TRANSPORT=http MCP_PORT=3001 MCP_PATH=/mcp MCP_ALLOWED_HOSTS=your-mcp-host.example TRANSPORT12_API_BASE_URL=http://127.0.0.1:3000 transport12-mcp

Если задан MCP_AUTH_TOKEN, клиент должен передавать:

Authorization: Bearer <token>

Переменные окружения

Переменная

Обязательна

По умолчанию

Назначение

TRANSPORT12_API_BASE_URL

да

нет

Базовый URL API transport12

MCP_TRANSPORT

нет

stdio

stdio или http

MCP_HOST

нет

127.0.0.1

Host для HTTP MCP

MCP_PORT

нет

3001

Port для HTTP MCP

MCP_PATH

нет

/mcp

Path для Streamable HTTP MCP

MCP_ALLOWED_HOSTS

нет

нет

Разрешенные внешние host-ы за reverse proxy

MCP_AUTH_TOKEN

нет

нет

Bearer token для защищенного HTTP MCP

Подключение к AI-клиентам и агентам

Claude Desktop

Стабильный вариант для Claude Desktop - локальный stdio MCP:

{
  "mcpServers": {
    "transport12": {
      "command": "npx",
      "args": ["-y", "transport12-mcp"],
      "env": {
        "TRANSPORT12_API_BASE_URL": "https://your-transport12-api.example"
      }
    }
  }
}

Если ваша версия Claude Desktop или рабочее пространство поддерживает удаленные MCP/connectors через интерфейс приложения, используйте URL:

https://transport12.yasg.ru/mcp

Если прямое подключение HTTP MCP в Claude Desktop недоступно, используйте локальный npx-вариант выше или Claude Code CLI.

Claude Code CLI

Удаленный MCP:

claude mcp add --transport http transport12 https://transport12.yasg.ru/mcp

Локальный MCP:

claude mcp add transport12 -- npx -y transport12-mcp

Для локального варианта добавьте TRANSPORT12_API_BASE_URL в окружение терминала или в JSON-конфигурацию Claude Code.

OpenAI Codex CLI

Локальный MCP в ~/.codex/config.toml:

[mcp_servers.transport12]
command = "npx"
args = ["-y", "transport12-mcp"]
env = { TRANSPORT12_API_BASE_URL = "https://your-transport12-api.example" }

Локальный MCP через CLI:

codex mcp add transport12 --env TRANSPORT12_API_BASE_URL=https://your-transport12-api.example -- npx -y transport12-mcp

Удаленный MCP в ~/.codex/config.toml:

[mcp_servers.transport12]
url = "https://transport12.yasg.ru/mcp"

Gemini CLI

Gemini CLI использует mcpServers в ~/.gemini/settings.json или .gemini/settings.json.

{
  "mcpServers": {
    "transport12": {
      "command": "npx",
      "args": ["-y", "transport12-mcp"],
      "env": {
        "TRANSPORT12_API_BASE_URL": "https://your-transport12-api.example"
      }
    }
  }
}

Qwen Code

Qwen Code поддерживает MCP и может настраиваться через qwen mcp или settings.json.

Удаленный MCP:

qwen mcp add --transport http transport12 https://transport12.yasg.ru/mcp

Локальный MCP:

qwen mcp add transport12 -- npx -y transport12-mcp

JSON-вариант:

{
  "mcpServers": {
    "transport12": {
      "command": "npx",
      "args": ["-y", "transport12-mcp"],
      "env": {
        "TRANSPORT12_API_BASE_URL": "https://your-transport12-api.example"
      }
    }
  }
}

Cursor, Windsurf, Cline, Roo Code, Kilo Code, Continue

Большинство IDE-агентов и расширений используют формат mcpServers.

{
  "mcpServers": {
    "transport12": {
      "command": "npx",
      "args": ["-y", "transport12-mcp"],
      "env": {
        "TRANSPORT12_API_BASE_URL": "https://your-transport12-api.example"
      }
    }
  }
}

Если клиент поддерживает remote MCP:

{
  "mcpServers": {
    "transport12": {
      "url": "https://transport12.yasg.ru/mcp"
    }
  }
}

VS Code, GitHub Copilot, Gemini Code Assist

Для клиентов VS Code, которые используют ключ servers, конфигурация обычно выглядит так:

{
  "servers": {
    "transport12": {
      "url": "https://transport12.yasg.ru/mcp"
    }
  }
}

Для расширений, которые используют mcpServers, применяйте общий JSON из раздела выше.

Zed

Для Zed используйте локальный stdio-вариант через npx или remote URL, если ваша версия клиента поддерживает HTTP MCP:

{
  "context_servers": {
    "transport12": {
      "command": {
        "path": "npx",
        "args": ["-y", "transport12-mcp"],
        "env": {
          "TRANSPORT12_API_BASE_URL": "https://your-transport12-api.example"
        }
      }
    }
  }
}

Cherry Studio, ChatWise, Trae AI, Tongyi Lingma

Для клиентов с китайской экосистемой используйте один из двух вариантов:

Локальный stdio:

{
  "mcpServers": {
    "transport12": {
      "command": "npx",
      "args": ["-y", "transport12-mcp"],
      "env": {
        "TRANSPORT12_API_BASE_URL": "https://your-transport12-api.example"
      }
    }
  }
}

Удаленный Streamable HTTP:

{
  "mcpServers": {
    "transport12": {
      "url": "https://transport12.yasg.ru/mcp"
    }
  }
}

Названия полей в конкретном клиенте могут отличаться: url, serverUrl, type, transport, headers. Если есть выбор транспорта, указывайте streamable-http или http.

Универсальный Streamable HTTP MCP

Для любого клиента с поддержкой remote MCP:

https://transport12.yasg.ru/mcp

Для защищенного endpoint добавьте Bearer token в настройках клиента:

Authorization: Bearer <token>

Подключение через платформы и LLM-провайдеры

YandexGPT / Yandex Cloud AI Studio

В Yandex Cloud AI Studio используйте MCP Hub и подключайте transport12 как внешний MCP-сервер. В настройках транспорта выбирайте HTTP/Streamable HTTP, если такой выбор доступен:

https://transport12.yasg.ru/mcp

Если нужен изолированный контур, разверните transport12-mcp в своей инфраструктуре и укажите внутренний URL.

GigaChat

Для GigaChat подключение обычно делается не в самом пользовательском чате, а через MCP-совместимый агентный слой: LangChain/LangGraph, LlamaIndex, Dify, Flowise, CrewAI, AutoGen, VoltAgent или собственный backend.

Рекомендуемый вариант:

GigaChat -> агент/оркестратор с MCP client -> https://transport12.yasg.ru/mcp

LangChain, LlamaIndex, Dify, Flowise, n8n, CrewAI, AutoGen, VoltAgent, Pipecat

Используйте transport12 как внешний MCP server. Для платформ с поддержкой HTTP MCP указывайте:

https://transport12.yasg.ru/mcp

Для платформ, которые умеют только stdio, запускайте пакет локально:

TRANSPORT12_API_BASE_URL=https://your-transport12-api.example npx -y transport12-mcp

Разработка

pnpm install
pnpm run check
pnpm run build

Проверить API:

TRANSPORT12_API_BASE_URL=https://your-transport12-api.example pnpm run smoke

Проверить HTTP MCP:

MCP_HTTP_URL=https://transport12.yasg.ru/mcp pnpm run smoke:http

Tools

  • health - проверить доступность API;

  • get_api_summary - получить границы и возможности MCP-интеграции;

  • get_service_status - проверить ключевые endpoint-ы API;

  • search_stops - найти остановки по названию;

  • find_nearby_stops - найти ближайшие остановки по координатам;

  • get_stop_routes - получить маршруты остановки;

  • get_stop_arrivals - получить фактическое прибытие транспорта на остановку;

  • search_routes - найти маршруты;

  • get_route - получить маршрут;

  • get_route_stops - получить остановки маршрута;

  • get_route_vehicles - получить транспорт на линии;

  • get_vehicle_forecast - получить прогноз движения конкретной машины;

  • search_bus_station_destinations - найти направления автовокзала;

  • get_bus_station_races - получить рейсы автовокзала на дату;

  • get_bus_station_calendar - получить наличие рейсов по датам для направления;

  • get_ticket_url - получить ссылку покупки билета или страницу рейса;

  • search_everything - единый поиск по остановкам, маршрутам и направлениям автовокзала.

Available Tools

17 tools
find_nearby_stopsFind nearby stopsB

Find nearest stops by latitude and longitude.

Inputs: lat (required), lng (required).

get_api_summaryGet API summaryA

Return the MCP-facing transport12 API capabilities and endpoint map.

Inputs: no named parameters.

get_bus_station_calendarGet bus station calendarB

Get bus station race availability by date for a destination. The transport12 API limits the range to the source-supported future window.

Inputs: destinationId (required), to, days, from.

get_bus_station_racesGet bus station racesC

Get bus station races for a destination and date.

Inputs: date (required), destinationId (required).

get_routeGet routeC

Get route details by id.

Inputs: routeId (required).

get_route_stopsGet route stopsC

Get route directions and stops.

Inputs: routeId (required).

get_route_vehiclesGet route vehiclesC

Get online vehicles for a route.

Inputs: routeId (required).

get_service_statusGet service statusB

Run lightweight checks against key transport12 API endpoints.

Inputs: no named parameters.

get_stop_arrivalsGet stop arrivalsC

Get factual arrival data for a stop.

Inputs: stationId (required).

get_stop_routesGet stop routesC

Get routes serving a stop.

Inputs: stationId (required).

get_ticket_urlGet ticket URLA

Return a compact ticket purchase URL for a bus station race when available.

Inputs: date (required), destinationId (required), raceId.

get_vehicle_forecastGet vehicle forecastA

Get upcoming stops for a vehicle device code.

Inputs: deviceCode (required).

healthHealthB

Check transport12 API availability. Returns a sanitized health payload.

Inputs: no named parameters.

search_bus_station_destinationsSearch bus station destinationsC

Search bus station destinations by settlement name.

Inputs: query (required).

search_everythingSearch everythingA

Search stops, routes, and bus station destinations with one query.

Inputs: query (required), limit.

search_routesSearch routesA

Search routes by number or name. If query is omitted, returns all routes.

Inputs: kind, query.

search_stopsSearch stopsB

Search transport stops by name.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 17 tools

    Disambiguation3/5

    Most tools have clear resource-specific boundaries, but health and get_service_status overlap in purpose, and get_bus_station_races versus get_bus_station_calendar may confuse agents about which returns actual races versus availability. search_everything also partially duplicates the individual search tools, though its aggregate intent is clear.

    Naming Consistency4/5

    The tool set follows a consistent snake_case verb_noun pattern with get_, search_, and find_ prefixes, making the API largely predictable. The lone 'health' tool breaks the pattern slightly, but it is still easily understood as a status check.

    Tool Count4/5

    With 17 tools, the server is at the upper edge of a reasonable size, but the breadth of the domain—stops, routes, vehicles, bus stations, and tickets—justifies the count. No tool feels redundant enough to remove outright, though the three health/summary tools could arguably be consolidated.

    Completeness4/5

    The server covers the core read-only workflows for a transit API: searching stops/routes, retrieving arrivals and vehicle forecasts, and exploring bus station races and ticket URLs. Minor gaps exist such as lack of a stop detail endpoint, route schedule/timetable data, or direct bus station lookup by ID, but agents can work around these with the provided surface.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for interacting with the Berlin Public Transport (BVG) API to search for locations and plan journeys. It provides real-time access to departures, arrivals, trip details, and vehicle tracking within Berlin's transit network.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server exposing Montevideo public transportation data (STM) as tools for AI assistants, enabling natural language queries about routes, stops, arrivals, and trip planning.
      17 npm
      1
      MIT