Сервер 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"
      ]
    }
  }
}

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

Замените YOUR_EBIRD_API_KEY на ваш фактический ключ API eBird
Создайте файл конфигурации, если его нет
Установите пакет глобально с помощью npm install -g ebird-mcp-server если вы еще этого не сделали.
Перезапустите Claude Desktop после сохранения изменений.

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

Функции

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

Недавние наблюдения за птицами в регионе
Недавние наблюдения за определенными видами птиц
Известные наблюдения за птицами в регионе
Наблюдения вблизи местоположения
Примечательные наблюдения вблизи местоположения
Горячие точки наблюдения за птицами в регионе
Точки доступа рядом с местоположением
Информация о таксономии eBird

Предпосылки

Node.js (v14 или более поздняя версия)
Ключ API eBird (получите его из запроса ключа API eBird )

Установка

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

Клонируйте этот репозиторий или загрузите файлы
Запустите скрипт установки Claude Desktop:

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

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

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

Клонируйте этот репозиторий или загрузите файлы
Запустите скрипт установки:

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

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

./run-ebird-mcp-server.sh

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

Клонируйте этот репозиторий или загрузите файлы
Установите зависимости:

npm install

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

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

eBird MCP Server

Integrations