Buses Coruña Agent Plugin

Plugin portable conforme a Agent Plugins v1.0.0. Reúne dos Agent Skills y un servidor MCP local para consultar la red de buses urbanos de A Coruña.

Componentes

• skills/skill-coruna-urban-bus-query/: paradas, líneas, rutas, POI y datos estáticos, con acceso vivo solo cuando la consulta lo requiere.
• skills/skill-coruna-bus-live-arrivals/: llegadas en tiempo real por parada, línea o vehículo mediante el API de iTranvias.
• mcp-server/: código fuente, pruebas y bundle distribuible del servidor MCP.
• plugin.json y mcp.json: manifiestos portables en las ubicaciones fijas del estándar.

Requisitos de ejecución

• Node.js 20.19 o posterior para el MCP.
• Python 3 para ejecutar los scripts incluidos en los skills.
• Acceso HTTP/HTTPS a itranvias.com para datos en tiempo real.

El MCP distribuido usa mcp-server/dist/main.js, un bundle autocontenido que no requiere npm install ni un directorio node_modules. Las consultas de catálogo y routing usan snapshots locales; solo las llegadas necesitan red pública.

Desarrollo y validación

Desde la raíz del plugin:

python3 scripts/validate_plugin.py
cd mcp-server && npm ci
npm run typecheck
npm test
npm run bundle
cd ..
python3 -m unittest discover -s skills/skill-coruna-urban-bus-query/tests
python3 skills/skill-coruna-bus-live-arrivals/scripts/query_arrivals.py --help

scripts/validate_plugin.py comprueba manifiestos, ubicaciones fijas, nombres de skills, rutas contenidas y archivos mínimos de runtime. Los esquemas oficiales v1.0.0 se conservan en schemas/1.0.0/ para auditoría y validación externa.

No incluyas .venv, node_modules, cachés, secretos ni datos generados durante una consulta. El MCP usa stdio por defecto y no debe escribir logs en stdout.