Skip to main content
Glama

bhoonidhi-mcp

Licencia: MIT

Un servidor MCP que permite a un agente de IA buscar, guardar, descargar y añadir al carrito escenas satelitales del portal Browse & Order de Bhoonidhi de ISRO (NRSC) en lenguaje natural. Un agente puede convertir una frase como "Sentinel-2 sobre Shillong el pasado enero" en una búsqueda real contra el portal en vivo, ver honestamente lo que está disponible para descargar, guardar una búsqueda para reutilizarla después, previsualizar lo que descargaría una descarga y — una vez iniciada la sesión — descargar escenas de acceso abierto o añadirlas al carrito.

Es un adaptador ligero sobre el bhoonidhi-downloader SDK — el mismo cliente que usa la CLI bhd — por lo que no se duplica lógica del portal.

Estado

Búsqueda y guardado sin inicio de sesión; descarga y carrito con uno. Las herramientas acceden al archivo completo de 41 misiones satelitales y 79 sensores, buscan en el portal en vivo y guardan búsquedas en slugs reutilizables — todo sin credenciales. Descargar escenas de acceso abierto y añadir escenas al carrito de Bhoonidhi requiere inicio de sesión, realizado fuera de banda con bhd auth login (el servidor reutiliza esa sesión).

Related MCP server: Google Earth Engine MCP Server

Herramientas

Herramienta

Qué hace

Inicio de sesión

list_archive

El vocabulario de satélites, sensores y tokens de búsqueda que soporta el portal, en vivo desde Bhoonidhi.

no

resolve_location

Convierte un nombre de lugar ("Lago Loktak") en un centroide y una caja delimitadora. Rechaza entradas que no sean nombres de lugar.

no

search_scenes

Búsqueda de escenas en lenguaje natural sobre un área y un rango de fechas. Resuelve un nombre de satélite informal a tokens exactos, e informa la disponibilidad de cada escena (Lista / Archivada / Bajo pedido / Con precio). Sin estado: no se guarda nada.

no

preview_download

Una prueba en seco: muestra qué descargaría la descarga de los resultados y qué se omitiría, antes de descargar nada.

no

save_query

Persiste una búsqueda (mismos argumentos que search_scenes) en un slug reutilizable, para poder descargarla o añadirla al carrito más tarde.

no

list_queries

Lista las búsquedas guardadas como resúmenes compactos: slug, nombre, rango de fechas, satélites, área y disponibilidad.

no

show_query

Devuelve una búsqueda guardada por slug, con sus escenas.

no

remove_query

Elimina una búsqueda guardada por slug.

no

auth_status

Informa si hay una sesión configurada. Nunca maneja una contraseña o token.

no

download_query

Descarga las escenas de acceso abierto de una búsqueda guardada en segundo plano, a una raíz fija configurada en el servidor. Devuelve un job_id de inmediato.

sí

download_status

Comprobación puntual de una descarga en segundo plano por job_id: bytes descargados, tasa de transferencia, porcentaje cuando se conoce el tamaño y detalle por escena.

no

download_wait

Bloquea hasta que una descarga termina (o un tiempo de espera máximo), y luego informa — el primitivo eficiente sobre el que un vigilante en segundo plano hace bucle.

no

cart_add

Añade las escenas de una búsqueda guardada al carrito (las enruta a lista / bajo pedido / con precio).

sí

cart_list

Lista las escenas actualmente en el carrito.

sí

cart_remove

Elimina escenas del carrito.

sí

La disponibilidad importa: una escena OpenData no está necesariamente preparada para descargar. search_scenes y preview_download distinguen Lista (descárgala ahora) de Archivada (datos abiertos, pero puede requerir una solicitud en el portal primero), para que un agente no prometa de más.

Las descargas se ejecutan en segundo plano, independientes de la conversación: download_query devuelve un job_id de inmediato y la transferencia continúa por su cuenta. Comprueba el progreso una vez con download_status — informa bytes descargados, una tasa de transferencia y un porcentaje una vez que se conoce el tamaño — o sigue un trabajo hasta su finalización con download_wait, que bloquea hasta que termina (o un tiempo de espera máximo) para que un agente pueda delegar un vigilante en segundo plano y mantener la conversación libre en lugar de hacer bucles de espera. Un trabajo vive solo mientras dura el proceso del servidor, así que una vez que una descarga resulta grande, el estado recomienda ejecutar un comando independiente bhd query download <slug> que tú controlas.

Instalación

El servidor es un paquete de Python con un punto de entrada de consola, bhoonidhi-mcp. Instálalo desde el código fuente con uv:

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

Esto expone el comando bhoonidhi-mcp en .venv/bin/bhoonidhi-mcp. El servidor habla stdio y es lanzado por un cliente MCP — apuntas el cliente a ese comando.

Conexión de un cliente

Todo cliente MCP necesita lo mismo: el comando para lanzar. Usa la ruta absoluta al punto de entrada (la más fiable entre clientes GUI y CLI):

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

Claude Desktop / Claude Code

claude_desktop_config.json (o 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 (para probarlo sin un agente)

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

Ejemplo

Pídele a un agente, en lenguaje sencillo:

"¿Qué escenas de Sentinel-2 hay sobre Shillong en enero de 2024, y cuántas puedo descargar realmente?"

El agente llama a resolve_location para Shillong, luego a search_scenes, y responde a partir del resultado — por ejemplo, que todas las escenas están Archivadas (datos abiertos, pero cada una puede requerir una solicitud en el portal antes de descargar), en lugar de afirmar que todas están listas.

Sugerencias para probar

Copia estas en cualquier agente conectado para hacerte una idea de lo que puede hacer.

Descubre el archivo

  • "¿Qué satélites y sensores tiene Bhoonidhi?"

  • "¿Qué sensores lleva ResourceSat-2A y a qué resolución?"

  • "¿Tiene Bhoonidhi algún satélite de radar?"

Busca escenas

  • "Encuentra escenas de Sentinel-2 sobre Shillong en enero de 2024."

  • "Muéstrame imágenes de Cartosat dentro de 20 km de Bengaluru en la primera mitad de 2024."

  • "¿Hay escenas de Sentinel-1 sobre los Sundarbans en marzo de 2024?"

  • "¿Qué imágenes de Landsat-8 cubren el Parque Nacional de Kaziranga el invierno pasado?"

  • "Encuentra escenas de MODIS sobre el Rann de Kutch en diciembre de 2023."

Comprueba qué está disponible para descargar

  • "De esas escenas de Sentinel-2, ¿cuántas puedo descargar realmente ahora mismo?"

  • "¿Cuáles de estas necesitan pedirse o pagarse?"

Previsualiza una descarga

  • "Previsualiza qué descargaría la descarga de esas escenas."

Guarda una búsqueda para reutilizar

  • "Guarda esa búsqueda de Sentinel-2 para poder descargarla más tarde."

  • "Lista mis búsquedas guardadas."

  • "Muéstrame qué hay en la búsqueda que guardé como ."

  • "Elimina la búsqueda guardada ."

Descarga y carrito (requiere inicio de sesión — ver más abajo)

  • "¿He iniciado sesión en Bhoonidhi?"

  • "Descarga las escenas de datos abiertos de mi búsqueda guardada ."

  • "¿Cómo va esa descarga?"

  • "Descarga y avísame cuando termine — seguiré trabajando."

  • "Añade las escenas con precio de a mi carrito."

  • "¿Qué hay en mi carrito esta semana?"

Inicio de sesión (para descargas y carrito)

La búsqueda, las búsquedas guardadas y las previsualizaciones no necesitan credenciales. Descargar escenas y añadirlas al carrito sí. Inicia sesión una vez, fuera de banda — el servidor reutiliza la misma sesión que escribe la CLI bhd:

bhd auth login

El servidor MCP nunca toma un nombre de usuario o contraseña como argumento de herramienta, y auth_status nunca devuelve tu token. Para una configuración sin cabeza sin inicio de sesión interactivo, puedes en su lugar establecer BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD en el entorno del servidor; el servidor los lee solo para establecer una sesión.

Configuración

Establece como variables de entorno (todas opcionales):

Variable

Valor por defecto

Propósito

BHOONIDHI_MCP_GEOCODER_USER_AGENT

bhoonidhi-mcp/0.1

User-Agent enviado a Nominatim (su política de uso pide uno descriptivo).

BHOONIDHI_MCP_FUZZY_THRESHOLD

88

Puntuación (0–100) que debe superar una coincidencia de nombre de satélite para ser confiable; por debajo, se devuelven candidatos para que el agente confirme.

BHOONIDHI_MCP_MAX_RESULTS

50

Máximo de escenas devueltas en línea por search_scenes.

BHOONIDHI_MCP_DOWNLOAD_ROOT

~/Downloads

Raíz permitida bajo la que se escribe cada descarga, como <root>/<slug>/. El agente no puede elegir una ruta arbitraria.

BHOONIDHI_MCP_DOWNLOAD_PARALLEL

4

Trabajadores de descarga en paralelo.

BHOONIDHI_MCP_LARGE_DOWNLOAD_MB

500

Una vez que el total de bytes en vivo (o el tamaño conocido) de una descarga supera esto, el estado la marca como grande y orienta al agente a delegar o ejecutar un comando independiente.

BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD

(sin establecer)

Inicio de sesión sin cabeza opcional. Prefiere bhd auth login; rellénalos fuera de banda, nunca los confirmes.

Desarrollo

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

Licencia

MIT — ver LICENSE.

Available Tools

15 tools
auth_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

    A4.3/5.0

    Scored across 15 tools

    Disambiguation5/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers