hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Used as the web framework for implementing the MCP server's API endpoints for bird detection data.
Used for version control and distribution of the MCP server codebase.
Hosts the repository for the MCP server code, enabling collaboration and distribution.
Servidor MCP BirdNet-Pi
Un servidor de Protocolo de Contexto de Modelo (MCP) basado en Python para la integración de BirdNet-Pi.
Características
- Recuperación de datos de detección de aves con filtrado de fechas y especies
- Estadísticas y análisis de detección
- Acceso a grabaciones de audio
- Patrones de actividad diaria
- Generación de informes
Requisitos
- Python 3.8+
- API rápida
- Uvicornio
- Otras dependencias enumeradas en
requirements.txt
Instalación
- Clonar el repositorio:
- Crea un entorno virtual y actívalo:
- Instalar dependencias:
- Configura tus directorios de datos:
Configuración
El servidor se puede configurar mediante variables de entorno:
BIRDNET_DETECTIONS_FILE: Ruta al archivo JSON de detecciones (predeterminado: 'data/detections.json')BIRDNET_AUDIO_DIR: Ruta al directorio de archivos de audio (predeterminado: 'data/audio')BIRDNET_REPORT_DIR: Ruta al directorio de informes (predeterminado: 'data/reports')
Ejecución del servidor
Iniciar el servidor:
El servidor se ejecutará en http://localhost:8000 .
Puntos finales de API
/functions- Lista de funciones disponibles (GET)/invoke- Invocar una función (POST)
Funciones disponibles
getBirdDetections- Obtenga detecciones de aves filtradas por rango de fechas y especie
- Parámetros: fecha de inicio, fecha de finalización, especie (opcional)
getDetectionStats- Obtener estadísticas de detección para un período de tiempo
- Parámetros: periodo ('día', 'semana', 'mes', 'todos'), minConfidence (opcional)
getAudioRecording- Obtener grabación de audio para una detección
- Parámetros: nombre de archivo, formato ('base64' o 'buffer')
getDailyActivity- Obtenga patrones de actividad de las aves para un día específico
- Parámetros: fecha, especie (opcional)
generateDetectionReport- Generar un informe de detecciones
- Parámetros: fecha de inicio, fecha de finalización, formato ('html' o 'json')
Estructura del directorio
This server cannot be installed
Un servidor basado en Python que permite acceder y analizar datos de detección de aves a través del Protocolo de Contexto de Modelo, ofreciendo funciones como filtrar detecciones, acceder a grabaciones de audio y generar informes.