IzmirMCP

IzmirMCP — Servidor MCP de Transporte Público de Izmir

IzmirMCP es un servidor TypeScript de código abierto que proporciona datos de transporte público de Izmir (IZBAN, ESHOT, Tranvía, Metro, Ferry/Izdeniz, Tren) a través del Protocolo de Contexto de Modelo (MCP). Hace que las ubicaciones de autobuses en tiempo real, los horarios de viajes y la información de paradas sean fácilmente accesibles para asistentes de IA (incluido Claude) y otros clientes MCP.

Conceptos clave orientados a SEO: API de transporte público de Izmir, ubicación de autobuses en tiempo real, horarios del metro de Izmir, viajes de IZBAN, paradas de ESHOT, servidor MCP, Protocolo de Contexto de Modelo.

---

¿Qué Ofrece?

• Integración MCP integral para los sistemas de transporte público de Izmir
• Datos en tiempo real: ubicaciones de autobuses y próximos viajes
• Horarios de viajes, listas de estaciones/paradas, búsqueda de líneas
• Estructura modular: herramientas de Izban, Eshot, Metro, Tranvía, Ferry y Tren
• Compatible con Node.js 18+, desarrollado con TypeScript

---

Sistemas Compatibles y Tipos de Datos

Sistema	Datos Ofrecidos
IZBAN	Lista de estaciones, viajes, tarifas
ESHOT	Búsqueda de paradas y líneas, autobuses próximos, ubicaciones GPS, paradas cercanas
Tranvía	Líneas, estaciones, frecuencia de viajes
Metro	Estaciones, frecuencia de viajes
Ferry (Izdeniz)	Muelles, horarios de salida, días de operación
Tren	Lista de estaciones de tren y ubicaciones

---

Instalación e Inicio Rápido

Ejecutar con NPM (recomendado)

npx izmir-mcp

Alternativamente, instalación global:

npm install -g izmir-mcp
izmir-mcp

IzmirMCP funciona con transporte stdio de MCP; no abre un puerto HTTP. Su cliente MCP gestiona este proceso a través de stdio.

Instalación desde el Código Fuente

git clone https://github.com/halilcengel/IzmirMCP.git
cd IzmirMCP
npm install
npm run build
npm start

---

Configuración del Cliente MCP (Claude, etc.)

{
  "mcpServers": {
    "izmir-mcp": {
      "command": "npx",
      "args": ["izmir-mcp"]
    }
  }
}

---

Ejemplos de Escenarios de Uso

Los siguientes ejemplos muestran cómo puede consultar datos de transporte público de Izmir en un cliente MCP:

ESHOT durak arama:
"Alsancak" bolgesindeki ESHOT duraklarini getir.

Hat uzerindeki otobus konumlari:
Hat 551 icin tum otobuslerin anlik GPS konumlarini getir.

Duraga yaklasan otobusler:
Durak ID 12345 icin yaklasan otobusleri listele.

IZBAN seferleri:
Aliağa (123) ile Alsancak (456) arasindaki IZBAN seferlerini getir.

Metro sefer sikligi:
Izmir metro sefer sikligini getir.

Vapur saatleri:
Karsiyaka - Alsancak arasi hafta ici vapur saatlerini getir.

Si lo desea, también puede convertir estas solicitudes en llamadas a herramientas MCP.

---

Herramientas

IZBAN

• get-izban-stations — Lista de estaciones
• get-izban-departures — Viajes programados entre dos estaciones
• get-izban-fare-tariff — Cálculo de tarifas

ESHOT

• get-eshot-stations — Búsqueda de paradas
• get-eshot-lines — Búsqueda de líneas
• get-line-approaching-buses — Autobuses próximos a una parada específica
• get-line-bus-locations — Ubicación GPS de todos los autobuses en una línea
• get-station-approaching-buses — Todos los autobuses que se acercan a una parada
• get-nearby-stations-by-coords — Paradas cercanas según coordenadas

Tranvía

• get-tram-lines — Todas las líneas
• get-tram-stations-by-sefer-id — Estaciones por ID de viaje
• get-tram-sefer-frequency-by-sefer-id — Frecuencia de viajes

Metro

• get-metro-stations — Lista de estaciones
• get-metro-sefer-frequencies — Frecuencia de viajes

Ferry (Izdeniz)

• get-ferry-timetables — Horarios de salida según salida/llegada y tipo de día
• get-ferry-timetables-by-pier — Horarios de salida por muelle
• get-ferry-working-days — Días de operación
• get-ferry-piers — Información de muelles

Tren

• get-train-stations — Lista de estaciones de tren

---

Variables de Entorno

Variable	Predeterminado	Descripción
MCP_NAME	IzmirMCP	Nombre del servidor MCP
BASE_URL	https://openapi.izmir.bel.tr/api	URL base de la API abierta de IBB
CKAN_BASE_URL	https://acikveri.bizizmir.com/api/3/action	URL base de la API CKAN de datos abiertos
ESHOT_HAT_RESOURCE_ID	bd6c84f8-49ba-4cf4-81f8-81a0fbb5caa3	ID de recurso de datos de líneas ESHOT
ESHOT_DURAK_RESOURCE_ID	0c791266-a2e4-4f14-82b8-9a9b102fbf94	ID de recurso de datos de paradas ESHOT
HTTP_TIMEOUT	10000	Tiempo de espera de solicitudes HTTP (ms)
MAX_RETRIES	3	Número de reintentos

---

Fuentes de Datos

Los datos se obtienen de la API abierta y las fuentes de datos abiertos de la Municipalidad Metropolitana de Izmir:

• https://openapi.izmir.bel.tr/api
• https://acikveri.bizizmir.com

---

Capturas de Pantalla

---

Contribuciones

Las contribuciones son bienvenidas:

1. Haga un fork del repositorio
2. Cree una nueva rama (git checkout -b ozellik/yenilik)
3. Haga commit de los cambios
4. Haga push de la rama
5. Cree una solicitud de extracción (Pull Request)

---

Licencia

Este proyecto está licenciado bajo la Licencia ISC.

---

Aviso de Responsabilidad

Este proyecto no es una aplicación oficial de la Municipalidad Metropolitana de Izmir. Los datos se obtienen de fuentes públicas. No se garantiza la precisión ni la actualidad de los datos.