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:

1. Reemplace YOUR_EBIRD_API_KEY con su clave API de eBird real

2. Crea el archivo de configuración si no existe

3. Instale el paquete globalmente con npm install -g ebird-mcp-server si aún no lo ha hecho

4. 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

Related MCP server: MCP Boilerplate

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

1. Clonar este repositorio o descargar los archivos

2. Ejecute el script de instalación de Claude Desktop:

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

3. Reiniciar Claude Desktop

Para otros clientes de MCP

1. Clonar este repositorio o descargar los archivos

2. Ejecute el script de instalación:

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

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

./run-ebird-mcp-server.sh

Instalación manual

1. Clonar este repositorio o descargar los archivos

2. Instalar dependencias:

npm install

3. 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