bhoonidhi-mcp

Сервер MCP, который позволяет ИИ-агенту искать, сохранять, скачивать и откладывать в корзину спутниковые сцены с портала Bhoonidhi Browse & Order (NRSC) на естественном языке. Агент может превратить фразу вроде «Sentinel-2 над Шиллонгом в прошлом январе» в реальный поиск по живому порталу, честно увидеть, что доступно для скачивания, сохранить поиск для повторного использования, посмотреть, что принесёт скачивание, и — после входа в систему — скачать сцены открытого доступа или отложить их в корзину.

Это тонкий адаптер над SDK bhoonidhi-downloader — тем же клиентом, который использует CLI bhd, — поэтому логика портала не дублируется.

Статус

Поиск и сохранение без входа; скачивание и корзина — со входом. Инструменты обращаются к полному архиву 41 спутниковой миссии и 79 сенсоров, ищут по живому порталу и сохраняют запросы в переиспользуемые slug — всё без учётных данных. Для скачивания сцен открытого доступа и добавления сцен в корзину Bhoonidhi требуется вход, который выполняется отдельно, с помощью bhd auth login (сервер переиспользует эту сессию).

Инструменты

Доступность имеет значение: сцена OpenData не обязательно готова к скачиванию. search_scenes и preview_download различают Ready (можно скачать сейчас) и Archived (открытые данные, но на портале может потребоваться запрос), чтобы агент не обещал лишнего.

Скачивание выполняется в фоне, независимо от диалога: download_query сразу возвращает job_id, и передача продолжается сама. Проверьте прогресс один раз с помощью download_status — он сообщает скачанные байты, скорость передачи и процент, когда размер известен, — или доведите задачу до конца с помощью download_wait, который блокирует выполнение до завершения (или до предельного таймаута), чтобы агент мог поручить фоновому наблюдателю и продолжать разговор, а не крутиться в цикле ожидания. Задача живёт только пока жив процесс сервера, поэтому, если скачивание оказывается большим, статус рекомендует выполнить отдельную команду bhd query download <slug>, которая останется у вас.

Установка

Сервер — это Python-пакет с консольной точкой входа bhoonidhi-mcp. Установите его из исходников с помощью uv:

git clone https://github.com/geovicco-dev/bhoonidhi-mcp
cd bhoonidhi-mcp
uv sync

Эта команда открывает bhoonidhi-mcp по пути .venv/bin/bhoonidhi-mcp. Сервер работает через stdio и запускается MCP-клиентом — вы указываете клиенту на эту команду.

Подключение клиента

Каждому MCP-клиенту нужно одно и то же: команда запуска. Используйте абсолютный путь к точке входа (надёжнее всего для GUI- и CLI-клиентов):

/path/to/bhoonidhi-mcp/.venv/bin/bhoonidhi-mcp

Claude Desktop / Claude Code

claude_desktop_config.json (или claude mcp add):

{
  "mcpServers": {
    "bhoonidhi": {
      "command": "/path/to/bhoonidhi-mcp/.venv/bin/bhoonidhi-mcp",
      "args": []
    }
  }
}

OpenCode

~/.config/opencode/opencode.json:

{
  "mcp": {
    "bhoonidhi": {
      "type": "local",
      "command": ["/path/to/bhoonidhi-mcp/.venv/bin/bhoonidhi-mcp"],
      "enabled": true
    }
  }
}

MCP Inspector (чтобы попробовать без агента)

npx @modelcontextprotocol/inspector /path/to/bhoonidhi-mcp/.venv/bin/bhoonidhi-mcp

Пример

Спросите агента простым языком:

«Какие сцены Sentinel-2 есть над Шиллонгом за январь 2024, и сколько из них я реально могу скачать?»

Агент вызывает resolve_location для Шиллонга, затем search_scenes и отвечает по результатам — например, что все сцены имеют статус Archived (открытые данные, но каждая может потребовать запроса на портале перед скачиванием), а не утверждает, что все готовы.

Примеры запросов для проверки

Скопируйте их в любого подключённого агента, чтобы понять, что он умеет.

Изучение архива

• «Какие спутники и сенсоры есть у Bhoonidhi?»

• «Какие сенсоры установлены на ResourceSat-2A и с каким разрешением?»

• «Есть ли у Bhoonidhi радиолокационные спутники?»

Поиск сцен

• «Найди сцены Sentinel-2 над Шиллонгом за январь 2024.»

• «Покажи снимки Cartosat в радиусе 20 км от Бенгалуру за первую половину 2024.»

• «Есть ли сцены Sentinel-1 над Сундарбаном за март 2024?»

• «Какие снимки Landsat-8 покрывают национальный парк Казиранга прошлой зимой?»

• «Найди сцены MODIS над Качским Ранном за декабрь 2023.»

Проверка доступности для скачивания

• «Из этих сцен Sentinel-2 сколько я могу скачать прямо сейчас?»

• «Какие из них нужно заказать или оплатить?»

Предпросмотр скачивания

• «Покажи, что принесёт скачивание этих сцен.»

Сохранение поиска для повторного использования

• «Сохрани этот поиск Sentinel-2, чтобы скачать его позже.»

• «Покажи мои сохранённые поиски.»

• «Покажи, что в поиске, который я сохранил как .»

• «Удали сохранённый поиск .»

Скачивание и корзина (нужен вход — см. ниже)

• «Я вошёл в Bhoonidhi?»

• «Скачай сцены открытого доступа из моего сохранённого поиска .»

• «Как идёт скачивание?»

• «Скачай и сообщи, когда закончишь, — я продолжу работать.»

• «Добавь платные сцены из в мою корзину.»

• «Что у меня в корзине на этой неделе?»

Вход (для скачивания и корзины)

Поиск, сохранённые запросы и предпросмотры не требуют учётных данных. Скачивание сцен и добавление их в корзину — требуют. Выполните вход один раз, вне MCP — сервер переиспользует ту же сессию, которую записывает CLI bhd:

bhd auth login

MCP-сервер никогда не принимает имя пользователя или пароль в качестве аргумента инструмента, и auth_status никогда не возвращает ваш токен. Для headless-установки без интерактивного входа можно вместо этого задать BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD в окружении сервера; сервер читает их только для установления сессии.

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

Задаётся переменными окружения (все необязательные):

Разработка

uv sync
uv run pytest        # test suite
uv run ruff check .  # lint

Лицензия

MIT — см. LICENSE.