bhoonidhi-mcp
bhoonidhi-mcp
Сервер MCP, который позволяет ИИ-агенту искать, сохранять, скачивать и откладывать в корзину спутниковые сцены с портала Bhoonidhi Browse & Order (NRSC) на естественном языке. Агент может превратить фразу вроде «Sentinel-2 над Шиллонгом в прошлом январе» в реальный поиск по живому порталу, честно увидеть, что доступно для скачивания, сохранить поиск для повторного использования, посмотреть, что принесёт скачивание, и — после входа в систему — скачать сцены открытого доступа или отложить их в корзину.
Это тонкий адаптер над SDK bhoonidhi-downloader — тем же клиентом, который использует CLI bhd, — поэтому логика портала не дублируется.
Статус
Поиск и сохранение без входа; скачивание и корзина — со входом. Инструменты обращаются к полному архиву 41 спутниковой миссии и 79 сенсоров, ищут по живому порталу и сохраняют запросы в переиспользуемые slug — всё без учётных данных. Для скачивания сцен открытого доступа и добавления сцен в корзину Bhoonidhi требуется вход, который выполняется отдельно, с помощью bhd auth login (сервер переиспользует эту сессию).
Related MCP server: Google Earth Engine MCP Server
Инструменты
Инструмент | Что делает | Вход |
| Словарь спутников, сенсоров и поисковых токенов, поддерживаемых порталом, в реальном времени с Bhoonidhi. | нет |
| Превращает название места («Loktak Lake») в центроид и ограничивающую рамку. Отклоняет входные данные, которые не являются названиями мест. | нет |
| Поиск сцен на естественном языке по области и диапазону дат. Приводит неформальное название спутника к точным токенам и сообщает доступность каждой сцены (Ready / Archived / OnOrder / Priced). Не хранит состояние — ничего не сохраняется. | нет |
| Сухой прогон: показывает, что принесёт скачивание результатов, а что будет пропущено, до начала скачивания. | нет |
| Сохраняет поисковый запрос (те же аргументы, что и | нет |
| Перечисляет сохранённые запросы в виде компактных сводок: slug, имя, диапазон дат, спутники, область и доступность. | нет |
| Возвращает один сохранённый запрос по slug и его сцены. | нет |
| Удаляет сохранённый запрос по slug. | нет |
| Сообщает, настроен ли вход. Никогда не обрабатывает пароль или токен. | нет |
| Скачивает сцены открытого доступа из сохранённого запроса в фоне, в фиксированный корневой каталог, заданный на сервере. Немедленно возвращает | да |
| Одноразовая проверка фонового скачивания по | нет |
| Блокирует выполнение до завершения скачивания (или предельного таймаута), затем сообщает результат — эффективный примитив, на котором фоновый наблюдатель строит цикл ожидания. | нет |
| Добавляет сцены сохранённого запроса в корзину (маршрутизирует каждую на ready / on-order / priced). | да |
| Перечисляет сцены, находящиеся в корзине. | да |
| Удаляет сцены из корзины. | да |
Доступность имеет значение: сцена 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-mcpClaude 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 loginMCP-сервер никогда не принимает имя пользователя или пароль в качестве аргумента инструмента, и auth_status никогда не возвращает ваш токен. Для headless-установки без интерактивного входа можно вместо этого задать BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD в окружении сервера; сервер читает их только для установления сессии.
Конфигурация
Задаётся переменными окружения (все необязательные):
Variable | Default | Purpose |
|
| User-Agent, отправляемый в Nominatim (его политика использования просит указывать описательный User-Agent). |
|
| Оценка (0–100), которую должно набрать совпадение названия спутника, чтобы считаться уверенным; ниже неё кандидаты возвращаются агенту для подтверждения. |
|
| Максимум сцен, возвращаемых инлайн в |
|
| Разрешённый корневой каталог, под который записываются все скачивания: |
|
| Параллельные загрузчики. |
|
| Когда текущий общий объём скачивания (или известный размер) превышает это значение, статус помечает его как большой и направляет агента к передаче задачи или выполнению отдельной команды. |
| (не задано) | Необязательный headless-вход. Предпочтительно |
Разработка
uv sync
uv run pytest # test suite
uv run ruff check . # lintЛицензия
MIT — см. LICENSE.
Available Tools
15 toolsauth_statusA
Report whether a Bhoonidhi login is configured for downloads and cart.
Never asks for or returns a password or token. If credentials are set in the server's environment (BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD) it establishes the session so the answer matches what a download or cart action would find. Returns authenticated=True with the username when a usable session exists, or authenticated=False with guidance to log in ('bhd auth login' out of band, or set those environment variables). Call this before download or cart actions to tell the user if a login is needed.
Inputs: no named parameters.
cart_addA
Stage a saved query's scenes to the Bhoonidhi cart.
Give the slug from save_query or list_queries. Each scene is routed to the cart its access type needs (ready / on-order / priced); select narrows to specific scenes (1-based indices or scene IDs). Needs a login (see auth_status). Use this for on-order and priced scenes; priced ones still need purchasing on the portal afterwards. Returns counts of what was staged and what failed.
Inputs: slug (required), select.
cart_listA
List scenes currently staged in the Bhoonidhi cart.
Cart items are filed by the date they were added; with no window this shows today only, so pass since/until (ISO dates, e.g. "2026-08-10") or last (e.g. "1 week") to widen it. filter_by limits to a state: ready, archived, onorder, or priced. Needs a login (see auth_status).
Inputs: last, since, until, filter_by.
cart_removeA
Remove scenes from the Bhoonidhi cart.
Two ways to address rows: pass slug to index a saved query's scenes, or omit it and let select index the merged cart itself (the same row numbers cart_list shows under the same since/until/last/filter_by window). Needs a login (see auth_status).
Inputs: last, slug, since, until, +2 more.
download_queryA
Download a saved query's open-access scenes in the background.
Give the slug from save_query or list_queries. Downloads run to a fixed, server-configured root (BHOONIDHI_MCP_DOWNLOAD_ROOT, default ~/Downloads), under a per-slug folder — you cannot choose an arbitrary path. select narrows to specific scenes (1-based indices or full scene IDs); omit it for the whole query. force re-downloads files already present.
Needs a login (see auth_status). Priced and on-order scenes are skipped — stage those with cart_add instead. Returns immediately with a job_id: the download runs on its own and does NOT depend on this conversation, so never block by sleeping and re-polling. To follow it hands-free, delegate a background watcher that loops download_wait on the job_id and reports back, keeping you free to keep talking; the result's 'handoff' note says so. File sizes are unknown until each transfer starts (the portal reveals them only then); once a download proves large, download_status/download_wait flag it and 'large_download' offers a standalone command that outlives this session. Interrupted downloads restart from scratch (no resume support).
Inputs: slug (required), force, select.
download_statusA
Check a background download started by download_query (one-off).
Give the job_id from download_query. Returns the live state: running (with bytes_downloaded, mb_downloaded, rate_mb_s, percent when the total size is known, and per-scene detail), completed (with per-scene outcomes), or failed (with the error). Use this for a single progress check. To follow a job to completion without tying up the conversation, use download_wait from a delegated watcher instead. Jobs exist only while the server runs; an unknown id returns status="not_found".
Inputs: job_id (required).
download_waitA
Wait for a background download to finish, then report — for a watcher.
Give the job_id from download_query. Blocks inside the server and returns as soon as the download completes or fails, or after timeout_s (capped at 120s) with the latest progress if still running. This is the efficient way to follow a job: a delegated background watcher calls it in a loop and stops when status is "completed" or "failed", so the main conversation is never blocked on sleeps. Prefer this over repeated sleep+download_status. An unknown id returns status="not_found".
Inputs: job_id (required), timeout_s.
list_archiveA
List every satellite and sensor the Bhoonidhi portal supports.
Returns the vocabulary of valid satellites, sensors, and exact search tokens, with each product's resolution and date coverage. Call this to discover what can be searched. Set refresh=True to bypass the local cache.
Inputs: refresh.
list_queriesA
List every saved query as compact summaries.
Returns each saved query's slug, name, date range, satellites, area of interest, scene count, and a plain-English availability summary — but not the full scene lists (call show_query for one query's scenes). Use this to find the slug for a query the user saved earlier.
Inputs: no named parameters.
preview_downloadA
Dry-run a download for a search: show what would be fetched, no login.
Takes the same arguments as search_scenes, plus out_dir (where files would go) and force (preview re-downloading files already present). It runs the search and predicts, per scene, what a real download would do: would_download (staged, ready), may_404 (open data but archived — attempted but may fail until requested on the portal), already_here / already_elsewhere (a matching file exists), or skipped_on_order / skipped_priced (needs the portal).
Use this before telling a user to download, so they know how many scenes are actually fetchable. Nothing is downloaded and no login is used. File sizes are not known until a download starts (the portal exposes them only in the download response headers), and interrupted downloads cannot be resumed — both are stated in the result's disclaimers.
Inputs: end_date (required), satellite (required), start_date (required), lat, +10 more.
remove_queryA
Delete a saved query by slug.
Give the slug from save_query or list_queries. Removes the saved query from disk; the scenes themselves are unaffected. Returns status="not_found" if no query has that slug.
Inputs: slug (required).
resolve_locationA
Resolve a place name to a centroid and bounding box.
Turns a place like "Shillong" or "Loktak Lake" into latitude/longitude and a bounding box (minx, miny, maxx, maxy) that search_scenes can use as its area of interest. Returns found=False when the place can't be resolved.
Inputs: name (required).
save_queryA
Persist a search as a saved query and return a reusable slug.
Takes the same arguments as search_scenes, plus an optional name and description. Unlike search_scenes (which is stateless and leaves nothing behind), this saves the search on the portal so it can be acted on later: the returned slug is what downloading and cart staging key off. Call this once the user has confirmed a search returns the scenes they want, then hand the slug to the bhd CLI (download / cart) until those actions land in-server.
Returns status="ok" with the slug and the shaped saved query. If the satellite is ambiguous or the request is invalid, returns the same status="ambiguous_satellite" / "invalid_request" shapes as search_scenes, and saves nothing.
Inputs: end_date (required), satellite (required), start_date (required), lat, +10 more.
search_scenesA
Search Bhoonidhi scenes for a satellite over an area and date range.
The satellite may be a casual name ("Sentinel-2", "cartosat"); it is matched to the portal's exact tokens, and a constellation expands to all its platforms. Dates are ISO (YYYY-MM-DD). Give the area either as a bounding box (minx/maxx/miny/maxy) or a point with radius (lat/lon/radius_km) — typically from resolve_location. sensor narrows to one sensor on the matched satellite(s) (e.g. "SSAR", "LISS3"); product further narrows to one product under that sensor (e.g. "GCOV", "L2C-Chlorophyll") — see list_archive for the exact sensor/product names each satellite carries. The search is stateless and needs no login.
If the satellite name is ambiguous, returns status="ambiguous_satellite" with candidate names instead of guessing.
Each scene carries an "availability": Ready (downloadable now), Archived (open data but may need a portal request first), OnOrder (must be requested), or Priced (must be purchased). The result includes a plain-English "summary" of these counts and a "how_to_act" block. Tell the user clearly when scenes are Archived, OnOrder, or Priced and what each needs. This search is stateless: to act on these scenes, call save_query with the same arguments to persist them and get a , then download_query (open data) or cart_add (on-order / priced) on that slug — both need a login (see auth_status). Downloads cannot be resumed if interrupted (the portal has no range support).
Inputs: end_date (required), satellite (required), start_date (required), lat, +8 more.
show_queryA
Return one saved query by slug, with its scenes.
Give the slug from save_query or list_queries. Returns the full saved query: its selections, area of interest, date range, and shaped scenes with availability. Returns status="not_found" if no query has that slug.
Inputs: slug (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each tool targets a distinct action or resource: search is separated from preview, save, download, and cart operations, and download_status vs download_wait are clearly one-off vs watcher. Even where arguments overlap, the descriptions draw explicit boundaries.
Most query tools follow verb_noun (remove_query, search_scenes, list_queries), but cart_* uses noun-verb order (cart_add, cart_list) and auth_status/download_status/download_wait are noun-phrase style. Everything is snake_case and readable, but the naming pattern is mixed rather than uniform.
15 tools is within the ideal range, and each tool covers a distinct stage of the archive-to-download/cart workflow. There is no apparent redundancy or padding.
The set covers discovery, geocoding, search, dry-run preview, saved-query lifecycle, auth status, download execution/monitoring, and cart management. Minor gaps like no in-server edit of saved queries, no active-download listing, and no direct archival request action are workarounds via the portal or CLI.
Maintenance
Related MCP Connectors
Geospatial AI MCP server — satellite imagery, embeddings, weather, GNS governance
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
FlicenseBqualityDmaintenanceAn MCP server that integrates AI retrievals with NASA's Common Metadata Repository (CMR), allowing users to search NASA's catalog of Earth science datasets through natural language queries.14-- AlicenseNot gradedqualityDmaintenanceMCP server for interacting with Google Earth Engine, enabling geospatial analysis such as dataset visualization, statistics computation, and search via AI assistants.16MIT
- AlicenseAqualityDmaintenanceA Python MCP server that provides unified access to satellite and geospatial data through natural language queries, with automatic place name geocoding and support for raster, vector, and Zarr formats.24Apache 2.0
- AlicenseNot gradedqualityAmaintenanceAn MCP server that connects AI agents to cloud-native geospatial data via STAC metadata and DuckDB with H3 spatial indexing, enabling zero-configuration SQL queries on terabyte-scale datasets over S3.22BSD 3-Clause