Сервер MCP eBird

Сервер Model Context Protocol (MCP) для интеграции с API eBird. Этот сервер позволяет помощникам ИИ, таким как Клод, получать доступ к данным наблюдения за птицами, горячим точкам и таксономической информации из eBird.

Быстрая настройка для Claude Desktop

Добавьте эту конфигурацию в файл конфигурации Claude Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

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

Обязательно:

1. Замените YOUR_EBIRD_API_KEY на ваш фактический ключ API eBird

2. Создайте файл конфигурации, если его нет

3. Установите пакет глобально с помощью npm install -g ebird-mcp-server если вы еще этого не сделали.

4. Перезапустите Claude Desktop после сохранения изменений.

Примечание : Вы можете получить ключ API eBird, отправив запрос на ключ API eBird.

Related MCP server: MCP Boilerplate

Функции

Сервер eBird MCP обеспечивает доступ к следующим данным eBird:

• Недавние наблюдения за птицами в регионе

• Недавние наблюдения за определенными видами птиц

• Известные наблюдения за птицами в регионе

• Наблюдения вблизи местоположения

• Примечательные наблюдения вблизи местоположения

• Горячие точки наблюдения за птицами в регионе

• Точки доступа рядом с местоположением

• Информация о таксономии eBird

Предпосылки

• Node.js (v14 или более поздняя версия)

• Ключ API eBird (получите его из запроса ключа API eBird )

Установка

Для рабочего стола Клода

1. Клонируйте этот репозиторий или загрузите файлы

2. Запустите скрипт установки Claude Desktop:

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

3. Перезагрузить рабочий стол Клода

Для других клиентов MCP

1. Клонируйте этот репозиторий или загрузите файлы

2. Запустите скрипт установки:

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

3. Теперь сервер установлен и может быть запущен с помощью:

./run-ebird-mcp-server.sh

Ручная установка

1. Клонируйте этот репозиторий или загрузите файлы

2. Установите зависимости:

npm install

3. Запускаем сервер:

node index.js --api-key YOUR_EBIRD_API_KEY

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

ebird_get_recent_observations

Получите последние данные о наблюдениях за птицами в регионе или местности.

Параметры:

• regionCode (обязательно): Код региона (например, US, US-NY, L123456)

• back : количество дней назад для поиска наблюдений (по умолчанию: 14)

• maxResults : максимальное количество возвращаемых результатов (по умолчанию: 100)

• includeProvisional : включить предварительные наблюдения (по умолчанию: true)

• hotspot : включать только наблюдения из hotspot (по умолчанию: false)

• detail : уровень детализации результатов («простой» или «полный», по умолчанию: «простой»)

ebird_get_recent_observations_for_species

Получите последние наблюдения за определенным видом птиц в регионе.

Параметры:

• regionCode (обязательно): Код региона (например, US, US-NY, L123456)

• speciesCode (обязательно): код вида eBird (например, amecro для американской вороны)

• back : количество дней назад для поиска наблюдений (по умолчанию: 14)

• maxResults : максимальное количество возвращаемых результатов (по умолчанию: 100)

• includeProvisional : Включить предварительные наблюдения (по умолчанию: true)

• hotspot : включать только наблюдения из hotspot (по умолчанию: false)

ebird_get_notable_observations

Получите сведения о примечательных птицах в регионе.

Параметры:

• regionCode (обязательно): Код региона (например, US, US-NY, L123456)

• back : количество дней назад для поиска наблюдений (по умолчанию: 14)

• maxResults : максимальное количество возвращаемых результатов (по умолчанию: 100)

• detail : Уровень детализации результатов («простой» или «полный», по умолчанию: «простой»)

ebird_get_nearby_observations

Получите последние данные о наблюдениях за птицами вблизи выбранного места.

Параметры:

• lat (обязательно): Координата широты

• lng (обязательно): Координата долготы

• dist : Расстояние в километрах от точки широты/долготы (по умолчанию: 25)

• back : количество дней назад для поиска наблюдений (по умолчанию: 14)

• maxResults : максимальное количество возвращаемых результатов (по умолчанию: 100)

• includeProvisional : включить предварительные наблюдения (по умолчанию: true)

• hotspot : включать только наблюдения из hotspot (по умолчанию: false)

• detail : уровень детализации результатов («простой» или «полный», по умолчанию: «простой»)

ebird_get_nearby_notable_observations

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

Параметры:

• lat (обязательно): Координата широты

• lng (обязательно): Координата долготы

• dist : Расстояние в километрах от точки широты/долготы (по умолчанию: 25)

• back : количество дней назад для поиска наблюдений (по умолчанию: 14)

• maxResults : максимальное количество возвращаемых результатов (по умолчанию: 100)

• detail : уровень детализации результатов («простой» или «полный», по умолчанию: «простой»)

ebird_получить_близлежащие_наблюдения_за_видами

Получите последние наблюдения за определенным видом птиц вблизи определенного места.

Параметры:

• lat (обязательно): Координата широты

• lng (обязательно): Координата долготы

• speciesCode (обязательно): код вида eBird (например, amecro для американской вороны)

• dist : Расстояние в километрах от точки широты/долготы (по умолчанию: 25)

• back : количество дней назад для поиска наблюдений (по умолчанию: 14)

• maxResults : максимальное количество возвращаемых результатов (по умолчанию: 100)

• includeProvisional : включить предварительные наблюдения (по умолчанию: true)

ebird_get_hotspots

Найдите популярные точки наблюдения за птицами в регионе.

Параметры:

• regionCode (обязательно): Код региона (например, US, US-NY)

• back : количество дней назад для поиска активности точек доступа (по умолчанию: 14)

• includeProvisional : включить предварительные наблюдения (по умолчанию: true)

ebird_get_nearby_hotspots

Найдите популярные точки наблюдения за птицами поблизости.

Параметры:

• lat (обязательно): Координата широты

• lng (обязательно): Координата долготы

• dist : Расстояние в километрах от точки широты/долготы (по умолчанию: 25)

• back : количество дней назад для поиска активности точек доступа (по умолчанию: 14)

• includeProvisional : включить предварительные наблюдения (по умолчанию: true)

ebird_get_taxonomy

Получите информацию о таксономии eBird.

Параметры:

• locale : Язык для общих имен (по умолчанию: 'en')

• cat : Таксономическая категория для фильтрации (по умолчанию: «вид»)

• fmt : Формат ответа (по умолчанию: «json»)

ebird_get_taxonomy_forms

Получите формы таксономии eBird для определенного вида.

Параметры:

• speciesCode (обязательно): код вида eBird

Тестирование

Чтобы протестировать сервер eBird MCP, установите свой ключ API eBird в качестве переменной среды и запустите тестовый скрипт:

export EBIRD_API_KEY=your_api_key
node test-ebird.js

Режим отладки

Чтобы включить режим отладки и просмотреть подробную логи:

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

Лицензия

Массачусетский технологический институт

Благодарности

• eBird за предоставление API

• Корнеллская лаборатория орнитологии за работу по сохранению птиц

• Модель контекстного протокола для интеграционной среды API