ITIS MCP Server

Сервер протокола контекста модели (MCP) для взаимодействия с базой данных ITIS (Интегрированная система таксономической информации) через их API SOLR.

Обзор

Этот MCP-сервер предоставляет доступ к базе данных ITIS, которая содержит таксономическую информацию о сотнях тысяч видов. Он использует API ITIS SOLR для выполнения поиска и получения таксономических данных.

Related MCP server: mcp-catalogueoflife

Функции

• Ответы на естественном языке: Используйте специализированные инструменты и подсказки, чтобы отвечать на повседневные вопросы, такие как «где живут белые медведи?» или «кто является родственником слона?»

• Поиск по научному названию: Поиск организмов по их научным названиям

• Поиск по народным/общеупотребительным названиям: Поиск организмов по их общеупотребительным названиям (например, «человек», «собака», «дуб»)

• Поиск по TSN: Поиск организмов по их таксономическому серийному номеру (Taxonomic Serial Number)

• Поиск по царству: Поиск организмов в пределах определенных царств

• Поиск по таксономическому рангу: Поиск организмов определенных рангов

• Поиск с автозаполнением: Получение подсказок для частичных научных названий

• Иерархические данные: Получение полных таксономических иерархий

• Географическая информация: Узнайте, где встречаются виды

• Общий поиск SOLR: Выполнение гибких поисковых запросов с использованием пользовательских запросов SOLR

• Открытие случайных видов: Получение случайных видов из любой таксономической группы с гибкой фильтрацией

• Статистика: Получение статистики базы данных

Использование

Как MCP-сервер

Сервер взаимодействует через stdin/stdout и может использоваться с клиентами, совместимыми с MCP.

Для запуска сервера:

npm start

Для разработки:

npm run dev

Вопросы на естественном языке

Этот сервер включает специальные подсказки и инструменты для легкого ответа на распространенные вопросы обывателей:

• «Расскажи мне о комодском варане» -> Использует подсказку species_profile и инструмент get_full_species_profile

• «Где живут белые медведи?» -> Использует подсказку where_does_it_live и инструмент get_geographic_info

• «Кто является родственником слона?» -> Использует подсказку animal_relatives и инструмент find_relatives

• «Какие виды входят в семейство кошачьих?» -> Использует подсказку whats_in_this_group и инструмент get_children

• «Как связаны собаки и волки?» -> Использует подсказку compare_animals

Конфигурация MCP-клиента

После сборки проекта добавьте эту конфигурацию в свой MCP-клиент:

Claude Desktop (claude_desktop_config.json):

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

Cursor/Другие MCP-клиенты:

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

Доступные инструменты

1. search_itis

Общий поиск SOLR с гибкими параметрами.

2. search_by_scientific_name

Поиск организмов по научному названию.

3. search_by_common_name

Поиск организмов по их повседневным общеупотребительным названиям (например, «собака», «слон»). Это обычно то, что нужно обычным пользователям, когда они спрашивают о животном или растении.

4. search_by_tsn

Поиск по таксономическому серийному номеру.

5. search_by_kingdom

Поиск в пределах определенного царства.

6. search_by_rank

Поиск по таксономическому рангу.

7. get_hierarchy

Получение таксономической иерархии для TSN.

8. autocomplete_search

Поиск с автозаполнением для частичных названий.

9. get_random_species

Получение случайных видов с дополнительными таксономическими фильтрами.

10. find_relatives

Показать родственников конкретного животного или растения. Принимает общеупотребительные или научные названия.

11. get_children

Найти все виды, содержащиеся в более крупной таксономической группе (например, «Felidae»).

12. get_geographic_info

Узнать, где живет организм (географические подразделения). Принимает общеупотребительные или научные названия.

13. get_full_species_profile

Получить полный профиль, включая иерархию, географию и синонимы за один раз.

14. explore_taxonomy

Исследование таксономических связей путем поиска родственных организмов на разных таксономических уровнях.

15. get_statistics

Получение статистики базы данных.

Примеры запросов

Вот несколько примеров запросов, которые вы можете использовать:

Поиск людей по научному названию

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

Поиск пум по общеупотребительному названию

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

Поиск растений

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

Автозаполнение для дубов

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

Получение случайных птиц

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

Получение случайных млекопитающих из отряда хищных (Carnivora)

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

Интеллектуальное обнаружение существ

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

Обнаружение морских птиц

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

Получение случайных растений

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

Пользовательский запрос SOLR

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

Поля базы данных ITIS

База данных ITIS содержит множество полей. Вот наиболее часто используемые из них:

• tsn: Таксономический серийный номер (уникальный идентификатор)

• nameWInd: Научное название с индикаторами

• kingdom: Название царства

• phylum: Название типа

• class: Название класса

• order: Название отряда

• family: Название семейства

• genus: Название рода

• species: Название вида

• author: Ссылка на автора

• rank: Таксономический ранг

• usage: Статус использования (действительный, недействительный и т.д.)

• credibilityRating: Рейтинг качества данных

• phyloSort: Порядок филогенетической сортировки

Примеры запросов SOLR

API ITIS SOLR поддерживает различные типы запросов:

• Точное совпадение: nameWInd:"Homo sapiens"

• Подстановочный знак: nameWInd:Homo*

• Диапазон: tsn:[1 TO 1000]

• Логический: kingdom:Animalia AND rank:Species

• Фраза: nameWInd:"oak tree"

Конфигурация

Сервер использует официальную конечную точку ITIS SOLR: https://services.itis.gov/

API-ключ не требуется, так как база данных ITIS находится в открытом доступе.

Обработка ошибок

Сервер включает комплексную обработку ошибок:

• Сетевые ошибки перехватываются и сообщаются

• Неверные запросы возвращают полезные сообщения об ошибках

• Некорректные ответы обрабатываются корректно

Участие в разработке

Не стесняйтесь присылать сообщения об ошибках и запросы на улучшение!

Лицензия

Лицензия MIT

Ссылки

• Веб-сайт ITIS

• Документация ITIS SOLR

• Протокол контекста модели (Model Context Protocol)