eBird MCP Server

Consulta datos detallados de observación de aves desde la API de eBird usando lenguaje natural.

Documentación

eBird MCP Server

Combina eBird con IA: Crea tu Asistente Personal de Observación de Aves

Este proyecto integra la API de eBird con un servidor MCP (Model Context Protocol), permitiéndote consultar datos de observación de aves mediante lenguaje natural directamente en la ventana de chat de Claude.

Comenzando

Requisitos previos

Clave de API de eBird: Crea una cuenta de eBird y solicita una clave de API.
Aplicación Claude Desktop: Descarga e instala la aplicación Claude Desktop.
Instala Python (Consulta este tutorial).

Instalación

Clona el repositorio

 git clone git@github.com:siansiansu/ebird-mcp-server.git
 cd ebird-mcp-server

Instala las dependencias

pip install -r requirements.txt

Configuración

Configura Claude Desktop

Abre Claude Desktop.
Ve a Configuración > Desarrollador > Editar Config > Editar archivo claude_desktop_config.json.
Reemplaza la configuración con tus rutas y clave de API:

{
  "mcpServers": {
    "ebird-api": {
      "command": "/absolute/path/to/python",
      "args": [
        "/absolute/path/to/ebird-mcp-server/server.py"
      ],
      "env": {
        "EBIRD_API_KEY": "your-ebird-api-key"
      }
    }
  }
}

Importante:

command: Ruta absoluta a tu ejecutable de Python.
args: Ruta absoluta a server.py.
EBIRD_API_KEY: Tu clave de API de eBird.

Reinicia Claude

Después de guardar la configuración, reinicia la aplicación Claude Desktop. Se iniciará automáticamente y gestionará el servidor MCP.

Uso

Abre un chat en Claude y usa cualquiera de los ejemplos de indicaciones (o los tuyos propios) para consultar datos de eBird.

Características

Aquí tienes ejemplos de indicaciones que puedes usar para consultar datos. La IA decidirá cuándo llamar al servidor MCP de eBird, o puedes indicarle explícitamente que lo haga.

Observaciones

Consulta observaciones recientes en una ubicación

What birds have been seen recently in Budai, Chiayi?

Consulta observaciones recientes de una especie

Are there any recent records of Black-faced Spoonbill in Tainan?

Consulta observaciones notables (raras)

What rare birds have been reported recently in Hsinchu?

Listas de verificación

Principales contribuyentes

List the top 100 eBird contributors in Taipei on June 26, 2025.

Todas las listas de verificación en una fecha

Show all checklists submitted in Kaohsiung on June 15, 2024.

Listas de verificación recientes

Provide the latest checklists submitted in Tainan.

Estadísticas resumidas

Summarize all observation checklists in New Taipei on June 20, 2024.

Detalles de la lista de verificación

Show details for checklist ID S12345678.

Puntos de observación

Lista los puntos de observación en una ubicación

List all eBird hotspots in Tainan.

Puntos de observación cercanos

List birding hotspots within 5 km of my current location.

Taxonomía

Taxonomía oficial

Provide the eBird taxonomy data for Black-faced Spoonbill.

Lista de subespecies

List all subspecies of White-breasted Waterhen.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.