Servidor MCP de eBird

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con la API de eBird. Este servidor permite a los asistentes de IA, como Claude, acceder a datos de observación de aves, puntos de acceso e información taxonómica de eBird.

Configuración rápida para Claude Desktop

Agregue esta configuración a su archivo de configuración de Claude Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "ebird-api": {
      "command": "npx",
      "args": [
        "ebird-mcp-server",
        "--api-key",
        "YOUR_EBIRD_API_KEY"
      ]
    }
  }
}

Asegúrese de:

Reemplace YOUR_EBIRD_API_KEY con su clave API de eBird real
Crea el archivo de configuración si no existe
Instale el paquete globalmente con npm install -g ebird-mcp-server si aún no lo ha hecho
Reinicie Claude Desktop después de guardar los cambios

Nota : Puede obtener una clave API de eBird desde la Solicitud de clave API de eBird

Características

El servidor MCP de eBird proporciona acceso a los siguientes datos de eBird:

Observaciones recientes de aves en una región
Observaciones recientes de especies de aves específicas
Observaciones de aves notables en una región
Observaciones cerca de una ubicación
Observaciones notables cerca de una ubicación
Puntos de interés para la observación de aves en una región
Puntos de acceso cerca de una ubicación
Información de taxonomía de eBird

Prerrequisitos

Node.js (v14 o posterior)
Una clave API de eBird (obtenga una en Solicitud de clave API de eBird )

Instalación

Para Claude Desktop

Clonar este repositorio o descargar los archivos
Ejecute el script de instalación de Claude Desktop:

chmod +x claude_setup.sh
./claude_setup.sh YOUR_EBIRD_API_KEY

Reiniciar Claude Desktop

Para otros clientes de MCP

Clonar este repositorio o descargar los archivos
Ejecute el script de instalación:

chmod +x install.sh
./install.sh YOUR_EBIRD_API_KEY

El servidor ya está instalado y se puede ejecutar con:

./run-ebird-mcp-server.sh

Instalación manual

Clonar este repositorio o descargar los archivos
Instalar dependencias:

npm install

Ejecutar el servidor:

node index.js --api-key YOUR_EBIRD_API_KEY

Herramientas disponibles

ebird_obtener_observaciones_recientes

Obtenga observaciones recientes de aves en una región o ubicación.

Parámetros:

regionCode (obligatorio): Código de región (p. ej., US, US-NY, L123456)
back : Número de días atrás para buscar observaciones (predeterminado: 14)
maxResults : Número máximo de resultados a devolver (predeterminado: 100)
includeProvisional : incluye observaciones provisionales (valor predeterminado: verdadero)
hotspot : solo incluye observaciones de puntos calientes (valor predeterminado: falso)
detail : Nivel de detalle de los resultados ('simple' o 'completo', predeterminado: 'simple')

ebird_obtener_observaciones_recientes_de_especies

Obtenga observaciones recientes de una especie de ave específica en una región.

Parámetros:

regionCode (obligatorio): Código de región (p. ej., US, US-NY, L123456)
speciesCode (obligatorio): código de especie de eBird (por ejemplo, amecro para cuervo americano)
back : Número de días atrás para buscar observaciones (predeterminado: 14)
maxResults : Número máximo de resultados a devolver (predeterminado: 100)
includeProvisional : incluye observaciones provisionales (valor predeterminado: verdadero)
hotspot : solo incluye observaciones de puntos calientes (valor predeterminado: falso)

ebird_obtener_observaciones_notables

Obtenga observaciones de aves notables en una región.

Parámetros:

regionCode (obligatorio): Código de región (p. ej., US, US-NY, L123456)
back : Número de días atrás para buscar observaciones (predeterminado: 14)
maxResults : Número máximo de resultados a devolver (predeterminado: 100)
detail : Nivel de detalle de los resultados ('simple' o 'completo', predeterminado: 'simple')

ebird_obtener_observaciones_cercanas

Obtenga observaciones recientes de aves cerca de una ubicación.

Parámetros:

lat (obligatorio): coordenada de latitud
lng (obligatorio): coordenada de longitud
dist : Distancia en kilómetros desde el punto lat/lng (predeterminado: 25)
back : Número de días atrás para buscar observaciones (predeterminado: 14)
maxResults : Número máximo de resultados a devolver (predeterminado: 100)
includeProvisional : incluye observaciones provisionales (valor predeterminado: verdadero)
hotspot : solo incluye observaciones de puntos calientes (valor predeterminado: falso)
detail : Nivel de detalle de los resultados ('simple' o 'completo', predeterminado: 'simple')

ebird_obtener_observaciones_notables_cercanas

Obtenga observaciones de aves notables cerca de una ubicación.

Parámetros:

lat (obligatorio): coordenada de latitud
lng (obligatorio): coordenada de longitud
dist : Distancia en kilómetros desde el punto lat/lng (predeterminado: 25)
back : Número de días atrás para buscar observaciones (predeterminado: 14)
maxResults : Número máximo de resultados a devolver (predeterminado: 100)
detail : Nivel de detalle de los resultados ('simple' o 'completo', predeterminado: 'simple')

ebird_obtener_observaciones_cercanas_de_especies

Obtenga observaciones recientes de una especie de ave específica cerca de una ubicación.

Parámetros:

lat (obligatorio): coordenada de latitud
lng (obligatorio): coordenada de longitud
speciesCode (obligatorio): código de especie de eBird (por ejemplo, amecro para cuervo americano)
dist : Distancia en kilómetros desde el punto lat/lng (predeterminado: 25)
back : Número de días atrás para buscar observaciones (predeterminado: 14)
maxResults : Número máximo de resultados a devolver (predeterminado: 100)
includeProvisional : incluye observaciones provisionales (valor predeterminado: verdadero)

ebird_obtener_puntos_de_acceso

Obtenga puntos de observación de aves en una región.

Parámetros:

regionCode (obligatorio): código de región (p. ej., EE. UU., EE. UU.-NY)
back : Número de días atrás para buscar actividad del punto de acceso (predeterminado: 14)
includeProvisional : incluye observaciones provisionales (valor predeterminado: verdadero)

ebird_obtener_puntos_de_acceso_cercanos

Obtenga puntos de observación de aves cercanos a una ubicación.

Parámetros:

lat (obligatorio): coordenada de latitud
lng (obligatorio): coordenada de longitud
dist : Distancia en kilómetros desde el punto lat/lng (predeterminado: 25)
back : Número de días atrás para buscar actividad del punto de acceso (predeterminado: 14)
includeProvisional : incluye observaciones provisionales (valor predeterminado: verdadero)

ebird_get_taxonomía

Obtenga información sobre la taxonomía de eBird.

Parámetros:

locale : idioma para nombres comunes (predeterminado: 'en')
cat : Categoría taxonómica por la que filtrar (predeterminado: 'especie')
fmt : Formato de respuesta (predeterminado: 'json')

ebird_get_taxonomy_forms

Obtenga formularios de taxonomía de eBird para una especie específica.

Parámetros:

speciesCode (obligatorio): código de especie de eBird

Pruebas

Para probar el servidor MCP de eBird, configure su clave API de eBird como una variable de entorno y ejecute el script de prueba:

export EBIRD_API_KEY=your_api_key
node test-ebird.js

Modo de depuración

Para habilitar el modo de depuración y ver el registro detallado:

node index.js --api-key YOUR_EBIRD_API_KEY --debug

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

eBird por proporcionar la API
Laboratorio de Ornitología de Cornell por su trabajo en la conservación de las aves
Protocolo de contexto de modelo para el marco de integración de API

eBird MCP Server

Integrations