Servidor MCP de ITIS

Un servidor del Protocolo de Contexto de Modelo (MCP) para interactuar con la base de datos del ITIS (Sistema Integrado de Información Taxonómica) a través de su API SOLR.

Descripción general

Este servidor MCP proporciona acceso a la base de datos del ITIS, que contiene información taxonómica de cientos de miles de especies. Utiliza la API SOLR de ITIS para realizar búsquedas y recuperar datos taxonómicos.

Related MCP server: mcp-catalogueoflife

Características

• Respuestas en lenguaje natural: Utiliza herramientas y prompts especializados para responder preguntas cotidianas como "¿dónde viven los osos polares?" o "¿qué está relacionado con el elefante?"

• Búsqueda por nombre científico: Encuentra organismos por sus nombres científicos

• Búsqueda por nombres vernáculos/comunes: Encuentra organismos por sus nombres comunes (p. ej., "humano", "perro", "roble")

• Búsqueda por TSN: Busca organismos por su Número de Serie Taxonómico (Taxonomic Serial Number)

• Búsqueda por reino: Encuentra organismos dentro de reinos específicos

• Búsqueda por rango taxonómico: Busca organismos de rangos específicos

• Búsqueda con autocompletado: Obtén sugerencias para nombres científicos parciales

• Datos jerárquicos: Recupera jerarquías taxonómicas completas

• Información geográfica: Mira dónde se encuentran las especies

• Búsqueda general SOLR: Realiza búsquedas flexibles con consultas SOLR personalizadas

• Descubrimiento de especies aleatorias: Obtén especies aleatorias de cualquier grupo taxonómico con filtrado flexible

• Estadísticas: Obtén estadísticas de la base de datos

Uso

Como servidor MCP

El servidor se comunica a través de stdin/stdout y puede utilizarse con clientes compatibles con MCP.

Para ejecutar el servidor:

npm start

Para desarrollo:

npm run dev

Preguntas en lenguaje natural

Este servidor incluye prompts y herramientas especiales para responder fácilmente a preguntas comunes de usuarios no expertos:

• "Háblame del dragón de Komodo" -> Utiliza el prompt species_profile y la herramienta get_full_species_profile

• "¿Dónde viven los osos polares?" -> Utiliza el prompt where_does_it_live y la herramienta get_geographic_info

• "¿Cuáles son los parientes del elefante?" -> Utiliza el prompt animal_relatives y la herramienta find_relatives

• "¿Qué especies hay en la familia de los gatos?" -> Utiliza el prompt whats_in_this_group y la herramienta get_children

• "¿Cómo están relacionados los perros y los lobos?" -> Utiliza el prompt compare_animals

Configuración del cliente MCP

Después de compilar el proyecto, añade esta configuración a tu cliente MCP:

Claude Desktop (claude_desktop_config.json):

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

Cursor/Otros clientes MCP:

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

Herramientas disponibles

1. search_itis

Búsqueda general SOLR con parámetros flexibles.

2. search_by_scientific_name

Busca organismos por nombre científico.

3. search_by_common_name

Busca organismos por sus nombres comunes cotidianos (p. ej., "perro", "elefante"). Esto es generalmente lo que los usuarios no expertos quieren cuando preguntan sobre un animal o planta.

4. search_by_tsn

Busca por Número de Serie Taxonómico.

5. search_by_kingdom

Busca dentro de un reino específico.

6. search_by_rank

Busca por rango taxonómico.

7. get_hierarchy

Obtén la jerarquía taxonómica para un TSN.

8. autocomplete_search

Búsqueda con autocompletado para nombres parciales.

9. get_random_species

Obtén especies aleatorias con filtros taxonómicos opcionales.

10. find_relatives

Muestra parientes de un animal o planta específico. Acepta nombres comunes o científicos.

11. get_children

Encuentra todas las especies contenidas dentro de un grupo taxonómico más grande (p. ej., "Felidae").

12. get_geographic_info

Averigua dónde vive un organismo (divisiones geográficas). Acepta nombres comunes o científicos.

13. get_full_species_profile

Obtén un perfil completo que incluye jerarquía, geografía y sinónimos de una sola vez.

14. explore_taxonomy

Explora relaciones taxonómicas encontrando organismos relacionados en diferentes niveles taxonómicos.

15. get_statistics

Obtén estadísticas de la base de datos.

Ejemplos de consultas

Aquí tienes algunos ejemplos de consultas que puedes usar:

Búsqueda de humanos por nombre científico

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

Búsqueda de pumas por nombre común

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

Búsqueda de plantas

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

Autocompletado para robles

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

Obtener aves aleatorias

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

Obtener mamíferos aleatorios de Carnivora

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

Descubrimiento inteligente de criaturas

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

Descubrir aves marinas

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

Obtener plantas aleatorias

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

Consulta SOLR personalizada

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

Campos de la base de datos ITIS

La base de datos ITIS contiene muchos campos. Estos son los más utilizados:

• tsn: Número de Serie Taxonómico (identificador único)

• nameWInd: Nombre científico con indicadores

• kingdom: Nombre del reino

• phylum: Nombre del filo

• class: Nombre de la clase

• order: Nombre del orden

• family: Nombre de la familia

• genus: Nombre del género

• species: Nombre de la especie

• author: Cita del autor

• rank: Rango taxonómico

• usage: Estado de uso (válido, inválido, etc.)

• credibilityRating: Calificación de calidad de los datos

• phyloSort: Orden de clasificación filogenética

Ejemplos de consultas SOLR

La API SOLR de ITIS admite varios tipos de consultas:

• Coincidencia exacta: nameWInd:"Homo sapiens"

• Comodín: nameWInd:Homo*

• Rango: tsn:[1 TO 1000]

• Booleana: kingdom:Animalia AND rank:Species

• Frase: nameWInd:"oak tree"

Configuración

El servidor utiliza el endpoint oficial de ITIS SOLR: https://services.itis.gov/

No se requiere clave de API ya que la base de datos ITIS es de acceso público.

Manejo de errores

El servidor incluye un manejo integral de errores:

• Los errores de red se detectan y reportan

• Las consultas no válidas devuelven mensajes de error útiles

• Las respuestas mal formadas se manejan correctamente

Contribución

¡Siéntete libre de enviar problemas y solicitudes de mejora!

Licencia

Licencia MIT

Referencias

• Sitio web de ITIS

• Documentación de ITIS SOLR

• Protocolo de Contexto de Modelo