Servidor ABS MCP
Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona acceso a la API de datos de la Oficina Australiana de Estadística (ABS). Este servidor permite a los asistentes de IA consultar y analizar datos estadísticos de la ABS a través de la API SDMX-ML.
Características
- Descubrimiento dinámico de todos los conjuntos de datos ABS disponibles a través de la API SDMX-ML
- Consultar conjuntos de datos ABS con filtros opcionales
- Compatibilidad con múltiples formatos de datos (JSON, CSV, XML)
- Construido sobre el protocolo MCP para una integración perfecta con asistentes de IA
- Sistema de almacenamiento en caché para un mejor rendimiento
- Registro completo y gestión de errores
Instalación
Desarrollo
Prerrequisitos
- Node.js 18 o superior
- npm 8 o superior
Edificio
Correr
Herramientas de desarrollo
npm run build : compila el código TypeScriptnpm start : Ejecutar el servidornpm run inspector : ejecuta el inspector MCP para realizar pruebas
Estructura del proyecto
src/
├── index.ts # Main server implementation
├── services/
│ └── abs/
│ ├── ABSApiClient.ts # ABS API communication
│ └── DataFlowService.ts # Data flow management and caching
├── types/
│ └── abs.ts # TypeScript type definitions
└── utils/
└── logger.ts # Logging configuration
Detalles de implementación
Cliente API de ABS
La clase ABSApiClient maneja la comunicación con la API de datos ABS:
- Utiliza el formato SDMX-ML para el intercambio de datos
- Admite múltiples formatos de respuesta (JSON, CSV, XML)
- Implementa el manejo y registro de errores adecuados
- Tiempos de espera y reintentos configurables
Servicio de flujo de datos
La clase DataFlowService administra los flujos de datos de ABS:
- Obtiene dinámicamente los conjuntos de datos disponibles de la API de ABS
- Implementa almacenamiento en caché con intervalos de actualización configurables
- Proporciona métodos para consultar conjuntos de datos específicos
- Maneja la transformación y el formato de datos.
Explotación florestal
Sistema de registro integral utilizando Winston:
- Registro a nivel de depuración para desarrollo
- Formato de registro JSON estructurado
- Opciones de consola y transporte de archivos
- Niveles y formatos de registro configurables
Integración con Claude Desktop
- Cierre Claude Desktop si se está ejecutando
- Inicie el servidor ABS MCP:
npm start - Iniciar Claude Desktop
- Las herramientas ABS deberían aparecer en la ventana "Herramientas MCP disponibles"
Documentación de la API
Para obtener más información sobre la API de datos ABS:
Contribuyendo
- Bifurcar el repositorio
- Crear una rama de características
- Realiza tus cambios
- Enviar una solicitud de extracción
Licencia
Licencia MIT