eBird MCP Server

eBird MCP Server

Ein Model Context Protocol (MCP)-Server zur Integration mit der eBird-API. Dieser Server ermöglicht KI-Assistenten wie Claude den Zugriff auf Vogelbeobachtungsdaten, Hotspots und Taxonomieinformationen von eBird.

Schnelleinrichtung für Claude Desktop

Fügen Sie diese Konfiguration zu Ihrer Claude Desktop-Konfigurationsdatei hinzu ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

Stellen Sie Folgendes sicher:

1. Ersetzen Sie YOUR_EBIRD_API_KEY durch Ihren tatsächlichen eBird-API-Schlüssel
2. Erstellen Sie die Konfigurationsdatei, falls sie nicht vorhanden ist
3. Installieren Sie das Paket global mit npm install -g ebird-mcp-server falls Sie dies noch nicht getan haben
4. Starten Sie Claude Desktop neu, nachdem Sie die Änderungen gespeichert haben

Hinweis : Sie können einen eBird-API-Schlüssel von eBird API Key Request erhalten.

Merkmale

Der eBird MCP-Server bietet Zugriff auf die folgenden eBird-Daten:

• Aktuelle Vogelbeobachtungen in einer Region
• Aktuelle Beobachtungen bestimmter Vogelarten
• Bemerkenswerte Vogelbeobachtungen in einer Region
• Beobachtungen in der Nähe eines Standorts
• Bemerkenswerte Beobachtungen in der Nähe eines Ortes
• Vogelbeobachtungs-Hotspots in einer Region
• Hotspots in der Nähe eines Standorts
• Informationen zur eBird-Taxonomie

Voraussetzungen

• Node.js (v14 oder höher)
• Ein eBird-API-Schlüssel (erhalten Sie einen über die eBird-API-Schlüsselanforderung )

Installation

Für Claude Desktop

1. Klonen Sie dieses Repository oder laden Sie die Dateien herunter
2. Führen Sie das Setup-Skript von Claude Desktop aus:

3. Starten Sie Claude Desktop neu

Für andere MCP-Clients

1. Klonen Sie dieses Repository oder laden Sie die Dateien herunter
2. Führen Sie das Installationsskript aus:

3. Der Server ist nun installiert und kann ausgeführt werden mit:

Manuelle Installation

1. Klonen Sie dieses Repository oder laden Sie die Dateien herunter
2. Installieren Sie Abhängigkeiten:

3. Führen Sie den Server aus:

Verfügbare Tools

ebird_get_recent_observations

Erhalten Sie aktuelle Vogelbeobachtungen in einer Region oder an einem Ort.

Parameter:

• regionCode (erforderlich): Regionalcode (z. B. US, US-NY, L123456)
• back : Anzahl der Tage zurück, um nach Beobachtungen zu suchen (Standard: 14)
• maxResults : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100)
• includeProvisional : Vorläufige Beobachtungen einschließen (Standard: true)
• hotspot : Nur Beobachtungen von Hotspots einschließen (Standard: false)
• detail : Detaillierungsgrad der Ergebnisse („einfach“ oder „vollständig“, Standard: „einfach“)

ebird_erhält_aktuelle_Beobachtungen_für_Arten

Erhalten Sie aktuelle Beobachtungen einer bestimmten Vogelart in einer Region.

Parameter:

• regionCode (erforderlich): Regionalcode (z. B. US, US-NY, L123456)
• speciesCode (erforderlich): eBird-Artencode (z. B. amecro für Amerikanische Krähe)
• back : Anzahl der Tage zurück, um nach Beobachtungen zu suchen (Standard: 14)
• maxResults : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100)
• includeProvisional : Vorläufige Beobachtungen einschließen (Standard: true)
• hotspot : Nur Beobachtungen von Hotspots einschließen (Standard: false)

ebird_get_notable_observations

Machen Sie bemerkenswerte Vogelbeobachtungen in einer Region.

Parameter:

• regionCode (erforderlich): Regionalcode (z. B. US, US-NY, L123456)
• back : Anzahl der Tage zurück, um nach Beobachtungen zu suchen (Standard: 14)
• maxResults : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100)
• detail : Detaillierungsgrad der Ergebnisse („einfach“ oder „vollständig“, Standard: „einfach“)

ebird_get_nearby_observations

Erhalten Sie aktuelle Vogelbeobachtungen in der Nähe eines Standorts.

Parameter:

• lat (erforderlich): Breitengradkoordinate
• lng (erforderlich): Längengradkoordinate
• dist : Entfernung in Kilometern vom Breiten-/Längenpunkt (Standard: 25)
• back : Anzahl der Tage zurück, um nach Beobachtungen zu suchen (Standard: 14)
• maxResults : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100)
• includeProvisional : Vorläufige Beobachtungen einschließen (Standard: true)
• hotspot : Nur Beobachtungen von Hotspots einschließen (Standard: false)
• detail : Detaillierungsgrad der Ergebnisse („einfach“ oder „vollständig“, Standard: „einfach“)

ebird_get_nearby_notable_observations

Machen Sie bemerkenswerte Vogelbeobachtungen in der Nähe eines Standorts.

Parameter:

• lat (erforderlich): Breitengradkoordinate
• lng (erforderlich): Längengradkoordinate
• dist : Entfernung in Kilometern vom Breiten-/Längenpunkt (Standard: 25)
• back : Anzahl der Tage zurück, um nach Beobachtungen zu suchen (Standard: 14)
• maxResults : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100)
• detail : Detaillierungsgrad der Ergebnisse („einfach“ oder „vollständig“, Standard: „einfach“)

ebird_erhalten_Artenbeobachtungen_in_der_Nähe

Erhalten Sie aktuelle Beobachtungen einer bestimmten Vogelart in der Nähe eines Standorts.

Parameter:

• lat (erforderlich): Breitengradkoordinate
• lng (erforderlich): Längengradkoordinate
• speciesCode (erforderlich): eBird-Artencode (z. B. amecro für Amerikanische Krähe)
• dist : Entfernung in Kilometern vom Breiten-/Längenpunkt (Standard: 25)
• back : Anzahl der Tage zurück, um nach Beobachtungen zu suchen (Standard: 14)
• maxResults : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 100)
• includeProvisional : Vorläufige Beobachtungen einschließen (Standard: true)

ebird_get_hotspots

Finden Sie Vogelbeobachtungs-Hotspots in einer Region.

Parameter:

• regionCode (erforderlich): Regionalcode (z. B. US, US-NY)
• back : Anzahl der Tage zurück, um nach Hotspot-Aktivität zu suchen (Standard: 14)
• includeProvisional : Vorläufige Beobachtungen einschließen (Standard: true)

ebird_get_nearby_hotspots

Holen Sie sich Vogelbeobachtungs-Hotspots in der Nähe eines Standorts.

Parameter:

• lat (erforderlich): Breitengradkoordinate
• lng (erforderlich): Längengradkoordinate
• dist : Entfernung in Kilometern vom Breiten-/Längenpunkt (Standard: 25)
• back : Anzahl der Tage zurück, um nach Hotspot-Aktivität zu suchen (Standard: 14)
• includeProvisional : Vorläufige Beobachtungen einschließen (Standard: true)

ebird_get_taxonomy

Holen Sie sich Informationen zur eBird-Taxonomie.

Parameter:

• locale : Sprache für allgemeine Namen (Standard: „en“)
• cat : Taxonomische Kategorie, nach der gefiltert werden soll (Standard: „Art“)
• fmt : Antwortformat (Standard: „json“)

ebird_get_taxonomy_forms

Holen Sie sich eBird-Taxonomieformulare für eine bestimmte Art.

Parameter:

• speciesCode (erforderlich): eBird-Artencode

Testen

Um den eBird MCP-Server zu testen, legen Sie Ihren eBird-API-Schlüssel als Umgebungsvariable fest und führen Sie das Testskript aus:

Debug-Modus

So aktivieren Sie den Debug-Modus und zeigen die detaillierte Protokollierung an:

Lizenz

MIT

Danksagung

• eBird für die Bereitstellung der API
• Cornell Lab of Ornithology für seine Arbeit zum Vogelschutz
• Model Context Protocol für das API-Integrationsframework