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 ):

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

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.

Related MCP server: MCP Boilerplate

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:

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

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:

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

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

./run-ebird-mcp-server.sh

Manuelle Installation

1. Klonen Sie dieses Repository oder laden Sie die Dateien herunter

2. Installieren Sie Abhängigkeiten:

npm install

3. Führen Sie den Server aus:

node index.js --api-key YOUR_EBIRD_API_KEY

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:

export EBIRD_API_KEY=your_api_key
node test-ebird.js

Debug-Modus

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

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

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