ITIS MCP-Server

Ein Model Context Protocol (MCP)-Server für die Interaktion mit der ITIS-Datenbank (Integrated Taxonomic Information System) über deren SOLR-API.

Übersicht

Dieser MCP-Server bietet Zugriff auf die ITIS-Datenbank, die taxonomische Informationen für Hunderttausende von Arten enthält. Er nutzt die ITIS SOLR-API, um Suchen durchzuführen und taxonomische Daten abzurufen.

Related MCP server: mcp-catalogueoflife

Funktionen

• Antworten in natürlicher Sprache: Verwenden Sie spezialisierte Tools und Prompts, um alltägliche Fragen zu beantworten, wie z. B. „Wo leben Eisbären?“ oder „Was ist mit dem Elefanten verwandt?“

• Suche nach wissenschaftlichem Namen: Finden Sie Organismen anhand ihrer wissenschaftlichen Namen

• Suche nach Trivialnamen/allgemeinen Namen: Finden Sie Organismen anhand ihrer gebräuchlichen Namen (z. B. „Mensch“, „Hund“, „Eiche“)

• Suche nach TSN: Suchen Sie Organismen anhand ihrer Taxonomic Serial Number (TSN)

• Suche nach Reich: Finden Sie Organismen innerhalb bestimmter Reiche

• Suche nach taxonomischem Rang: Suchen Sie nach Organismen bestimmter Ränge

• Autovervollständigungssuche: Erhalten Sie Vorschläge für teilweise wissenschaftliche Namen

• Hierarchische Daten: Rufen Sie vollständige taxonomische Hierarchien ab

• Geografische Informationen: Sehen Sie, wo Arten vorkommen

• Allgemeine SOLR-Suche: Führen Sie flexible Suchen mit benutzerdefinierten SOLR-Abfragen durch

• Zufällige Artenentdeckung: Erhalten Sie zufällige Arten aus jeder taxonomischen Gruppe mit flexibler Filterung

• Statistiken: Erhalten Sie Datenbankstatistiken

Verwendung

Als MCP-Server

Der Server kommuniziert über stdin/stdout und kann mit MCP-kompatiblen Clients verwendet werden.

So starten Sie den Server:

npm start

Für die Entwicklung:

npm run dev

Fragen in natürlicher Sprache

Dieser Server enthält spezielle Prompts und Tools, um häufige Fragen von Laien einfach zu beantworten:

• „Erzähl mir etwas über den Komodowaran“ -> Verwendet den species_profile-Prompt und das get_full_species_profile-Tool

• „Wo leben Eisbären?“ -> Verwendet den where_does_it_live-Prompt und das get_geographic_info-Tool

• „Was sind die Verwandten des Elefanten?“ -> Verwendet den animal_relatives-Prompt und das find_relatives-Tool

• „Welche Arten gehören zur Katzenfamilie?“ -> Verwendet den whats_in_this_group-Prompt und das get_children-Tool

• „Wie sind Hunde und Wölfe verwandt?“ -> Verwendet den compare_animals-Prompt

MCP-Client-Konfiguration

Fügen Sie nach dem Erstellen des Projekts diese Konfiguration zu Ihrem MCP-Client hinzu:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "itis": {
      "command": "npx",
      "args": ["-y", "path/to/itis-mcp"]
    }
  }
}

Cursor/Andere MCP-Clients:

{
  "command": "npx",
  "args": ["-y", "path/to/itis-mcp"]
}

Verfügbare Tools

1. search_itis

Allgemeine SOLR-Suche mit flexiblen Parametern.

2. search_by_scientific_name

Suche nach Organismen anhand des wissenschaftlichen Namens.

3. search_by_common_name

Suche nach Organismen anhand ihrer alltäglichen Trivialnamen (z. B. „Hund“, „Elefant“). Dies ist normalerweise das, was Laien suchen, wenn sie nach einem Tier oder einer Pflanze fragen.

4. search_by_tsn

Suche nach Taxonomic Serial Number.

5. search_by_kingdom

Suche innerhalb eines bestimmten Reichs.

6. search_by_rank

Suche nach taxonomischem Rang.

7. get_hierarchy

Abrufen der taxonomischen Hierarchie für eine TSN.

8. autocomplete_search

Autovervollständigungssuche für Teilnamen.

9. get_random_species

Abrufen zufälliger Arten mit optionalen taxonomischen Filtern.

10. find_relatives

Anzeigen von Verwandten eines bestimmten Tieres oder einer Pflanze. Akzeptiert Trivialnamen oder wissenschaftliche Namen.

11. get_children

Finden aller Arten, die in einer größeren taxonomischen Gruppe enthalten sind (z. B. „Felidae“).

12. get_geographic_info

Herausfinden, wo ein Organismus lebt (geografische Einteilungen). Akzeptiert Trivialnamen oder wissenschaftliche Namen.

13. get_full_species_profile

Abrufen eines umfassenden Profils einschließlich Hierarchie, Geografie und Synonymen in einem Schritt.

14. explore_taxonomy

Erkunden taxonomischer Beziehungen durch das Finden verwandter Organismen auf verschiedenen taxonomischen Ebenen.

15. get_statistics

Abrufen von Datenbankstatistiken.

Beispielabfragen

Hier sind einige Beispielabfragen, die Sie verwenden können:

Suche nach Menschen nach wissenschaftlichem Namen

{
  "tool": "search_by_scientific_name",
  "arguments": {
    "name": "Homo sapiens"
  }
}

Suche nach Pumas nach Trivialnamen

{
  "tool": "search_by_vernacular_name",
  "arguments": {
    "vernacularName": "cougar"
  }
}

Suche nach Pflanzen

{
  "tool": "search_by_kingdom",
  "arguments": {
    "kingdom": "Plantae",
    "rows": 5
  }
}

Autovervollständigung für Eichen

{
  "tool": "autocomplete_search",
  "arguments": {
    "partialName": "Quercus"
  }
}

Zufällige Vögel abrufen

{
  "tool": "get_random_species",
  "arguments": {
    "kingdom": "Animalia",
    "class": "Aves",
    "count": 3,
    "requireVernacular": true
  }
}

Zufällige Säugetiere aus der Ordnung Carnivora abrufen

{
  "tool": "get_random_species",
  "arguments": {
    "kingdom": "Animalia",
    "class": "Mammalia",
    "order": "Carnivora",
    "count": 2,
    "requireVernacular": true
  }
}

Intelligente Kreaturensuche

{
  "prompt": "random_creature_discovery",
  "arguments": {
    "creature_type": "big cats",
    "count": 3
  }
}

Seevögel entdecken

{
  "prompt": "random_creature_discovery",
  "arguments": {
    "creature_type": "sea birds",
    "count": 2,
    "focus_area": "diving birds"
  }
}

Zufällige Pflanzen abrufen

{
  "tool": "get_random_species",
  "arguments": {
    "kingdom": "Plantae",
    "count": 2,
    "requireVernacular": true
  }
}

Benutzerdefinierte SOLR-Abfrage

{
  "tool": "search_itis",
  "arguments": {
    "query": "nameWInd:*tiger* AND kingdom:Animalia",
    "rows": 10,
    "sort": "nameWInd asc"
  }
}

ITIS-Datenbankfelder

Die ITIS-Datenbank enthält viele Felder. Hier sind die am häufigsten verwendeten:

• tsn: Taxonomic Serial Number (eindeutige Kennung)

• nameWInd: Wissenschaftlicher Name mit Indikatoren

• kingdom: Name des Reichs

• phylum: Name des Stammes

• class: Name der Klasse

• order: Name der Ordnung

• family: Name der Familie

• genus: Name der Gattung

• species: Name der Art

• author: Autorenzitat

• rank: Taxonomischer Rang

• usage: Nutzungsstatus (gültig, ungültig usw.)

• credibilityRating: Datenqualitätsbewertung

• phyloSort: Phylogenetische Sortierreihenfolge

SOLR-Abfragebeispiele

Die ITIS SOLR-API unterstützt verschiedene Abfragetypen:

• Exakte Übereinstimmung: nameWInd:"Homo sapiens"

• Platzhalter: nameWInd:Homo*

• Bereich: tsn:[1 TO 1000]

• Boolesch: kingdom:Animalia AND rank:Species

• Phrase: nameWInd:"oak tree"

Konfiguration

Der Server verwendet den offiziellen ITIS SOLR-Endpunkt: https://services.itis.gov/

Es ist kein API-Schlüssel erforderlich, da die ITIS-Datenbank öffentlich zugänglich ist.

Fehlerbehandlung

Der Server enthält eine umfassende Fehlerbehandlung:

• Netzwerkfehler werden abgefangen und gemeldet

• Ungültige Abfragen geben hilfreiche Fehlermeldungen zurück

• Fehlerhafte Antworten werden ordnungsgemäß verarbeitet

Mitwirken

Reichen Sie gerne Probleme und Verbesserungsvorschläge ein!

Lizenz

MIT-Lizenz

Referenzen

• ITIS-Website

• ITIS SOLR-Dokumentation

• Model Context Protocol