Skip to main content
Glama

bhoonidhi-mcp

License: MIT

AI 에이전트가 ISRO의 Bhoonidhi Browse & Order 포털(NRSC)에서 위성 장면을 자연어로 검색, 저장, 다운로드, 장바구니에 담을 수 있게 해주는 MCP 서버입니다. 에이전트는 "지난 1월 실롱 위의 Sentinel-2" 같은 문장을 실제 포털에 대한 실제 검색으로 바꾸고, 다운로드 가능한 항목을 정직하게 확인하며, 나중에 재사용할 검색을 저장하고, 다운로드가 가져올 내용을 미리 보고, 로그인 후에는 오픈 액세스 장면을 다운로드하거나 장바구니에 단계적으로 담을 수 있습니다.

이것은 bhoonidhi-downloader SDK( bhd CLI가 사용하는 것과 동일한 클라이언트) 위의 얇은 어댑터이므로 포털 로직이 중복되지 않습니다.

상태

로그인 없이 검색 및 저장, 로그인으로 다운로드 및 장바구니. 이 도구는 41개 위성 임무와 79개 센서의 전체 아카이브에 도달하고, 실시간 포털을 검색하며, 재사용 가능한 슬러그로 검색을 저장합니다 — 모두 자격 증명 없이 가능합니다. 오픈 액세스 장면 다운로드 및 Bhoonidhi 장바구니에 장면 단계적 추가는 로그인이 필요하며, bhd auth login으로 대역 외에서 수행됩니다(서버는 해당 세션을 재사용합니다).

Related MCP server: Google Earth Engine MCP Server

도구

도구

기능

로그인

list_archive

포털이 지원하는 위성, 센서, 검색 토큰의 어휘를 Bhoonidhi에서 실시간으로 제공합니다.

아니요

resolve_location

장소 이름("로크타크 호수")을 중심점과 경계 상자로 변환합니다. 장소 이름이 아닌 입력은 거부합니다.

아니요

search_scenes

지역 및 날짜 범위에 대한 자연어 장면 검색. 캐주얼한 위성 이름을 정확한 토큰으로 해석하고, 각 장면의 가용성(Ready / Archived / OnOrder / Priced)을 보고합니다. 상태 비저장 — 저장되지 않습니다.

아니요

preview_download

드라이 런: 다운로드가 가져올 내용과 건너뛸 내용을 다운로드 전에 보여줍니다.

아니요

save_query

검색(search_scenes와 동일한 인수)을 재사용 가능한 슬러그로 저장하여 나중에 다운로드하거나 장바구니에 담을 수 있습니다.

아니요

list_queries

저장된 쿼리를 간결한 요약으로 나열합니다: 슬러그, 이름, 날짜 범위, 위성, 지역, 가용성.

아니요

show_query

슬러그로 저장된 쿼리 하나를 장면과 함께 반환합니다.

아니요

remove_query

슬러그로 저장된 쿼리를 삭제합니다.

아니요

auth_status

로그인이 구성되었는지 보고합니다. 비밀번호나 토큰을 절대 처리하지 않습니다.

아니요

download_query

저장된 쿼리의 오픈 액세스 장면을 서버 구성 루트 아래에 백그라운드로 다운로드합니다. 즉시 job_id를 반환합니다.

예

download_status

job_id로 백그라운드 다운로드를 일회성 확인: 다운로드된 바이트, 전송 속도, 크기를 알 때 백분율, 장면별 세부 정보.

아니요

download_wait

다운로드가 완료될 때까지(또는 상한 시간 초과) 차단한 후 보고 — 백그라운드 감시자가 반복하는 효율적인 기본 요소.

아니요

cart_add

저장된 쿼리의 장면을 장바구니에 단계적으로 추가합니다(각각 ready / on-order / priced로 라우팅).

예

cart_list

현재 장바구니에 단계적으로 추가된 장면을 나열합니다.

예

cart_remove

장바구니에서 장면을 제거합니다.

예

가용성이 중요합니다: OpenData 장면이 반드시 다운로드용으로 준비된 것은 아닙니다. search_scenes와 preview_download는 Ready(지금 가져오기)와 Archived(오픈 데이터이지만 포털에서 먼저 요청이 필요할 수 있음)를 구분하므로 에이전트가 과장하지 않습니다.

다운로드는 대화와 독립적으로 백그라운드에서 실행됩니다: download_query는 즉시 job_id를 반환하고 전송은 자체적으로 진행됩니다. download_status로 한 번 진행 상황을 확인하거나(다운로드된 바이트, 전송 속도, 크기를 알면 백분율 보고) download_wait로 작업 완료를 따를 수 있습니다. 이는 완료될 때까지(또는 상한 시간 초과) 차단하므로 에이전트가 백그라운드 감시자를 위임하고 대화를 자유롭게 유지할 수 있습니다(수면 루프 대신). 작업은 서버 프로세스가 살아있는 동안만 존재하므로, 다운로드가 크다는 것이 입증되면 상태는 독립 실행형 bhd query download <slug> 명령을 실행하도록 권장합니다.

설치

서버는 콘솔 진입점 bhoonidhi-mcp가 있는 Python 패키지입니다. uv로 소스에서 설치하세요:

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

이렇게 하면 .venv/bin/bhoonidhi-mcp에 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

예시

에이전트에게 평이한 언어로 물어보세요:

"2024년 1월 실롱 위의 Sentinel-2 장면은 무엇이며, 실제로 다운로드할 수 있는 것은 몇 개인가요?"

에이전트는 실롱에 대해 resolve_location을 호출한 다음 search_scenes를 호출하고 결과에서 답합니다 — 예를 들어 모든 장면이 Archived(오픈 데이터이지만 각각 다운로드 전에 포털에서 요청이 필요할 수 있음)라고 말하는 대신 모두 준비되었다고 주장하지 않습니다.

시도할 프롬프트

연결된 에이전트에 복사하여 무엇을 할 수 있는지 느껴보세요.

아카이브 탐색

  • "Bhoonidhi에는 어떤 위성과 센서가 있나요?"

  • "ResourceSat-2A는 어떤 센서를 탑재하고 있으며, 해상도는 얼마인가요?"

  • "Bhoonidhi에 레이더 위성이 있나요?"

장면 검색

  • "2024년 1월 실롱 위의 Sentinel-2 장면을 찾아주세요."

  • "2024년 상반기 벵갈루루에서 20km 이내의 Cartosat 이미지를 보여주세요."

  • "2024년 3월 순다르반스 위의 Sentinel-1 장면이 있나요?"

  • "지난 겨울 카지랑가 국립공원을 덮는 Landsat-8 이미지는 무엇인가요?"

  • "2023년 12월 카치의 란 위의 MODIS 장면을 찾아주세요."

다운로드 가능한 항목 확인

  • "그 Sentinel-2 장면 중 지금 실제로 다운로드할 수 있는 것은 몇 개인가요?"

  • "이 중 주문하거나 비용을 지불해야 하는 것은 무엇인가요?"

다운로드 미리 보기

  • "그 장면들을 다운로드하면 무엇을 가져올지 미리 보여주세요."

재사용할 검색 저장

  • "나중에 다운로드할 수 있도록 그 Sentinel-2 검색을 저장해주세요."

  • "저장된 검색을 나열해주세요."

  • "로 저장한 검색에 무엇이 있는지 보여주세요."

  • "저장된 검색 을 삭제하세요."

다운로드 및 장바구니 (로그인 필요 — 아래 참조)

  • "Bhoonidhi에 로그인되어 있나요?"

  • "저장된 검색 의 오픈 데이터 장면을 다운로드하세요."

  • "그 다운로드 진행 상황은 어떤가요?"

  • "을 다운로드하고 완료되면 알려주세요 — 계속 작업하겠습니다."

  • "의 유료 장면을 내 장바구니에 추가하세요."

  • "이번 주 내 장바구니에는 무엇이 있나요?"

로그인 (다운로드 및 장바구니용)

검색, 저장된 쿼리, 미리 보기에는 자격 증명이 필요 없습니다. 장면 다운로드 및 장바구니 단계적 추가에는 필요합니다. 대역 외에서 한 번 로그인하세요 — 서버는 bhd CLI가 쓰는 것과 동일한 세션을 재사용합니다:

bhd auth login

MCP 서버는 도구 인수로 사용자 이름이나 비밀번호를 절대 받지 않으며, auth_status는 토큰을 절대 반환하지 않습니다. 대화형 로그인이 없는 헤드리스 설정의 경우 서버 환경에 BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD를 설정할 수 있습니다. 서버는 세션을 설정하는 데만 이를 읽습니다.

구성

환경 변수로 설정(모두 선택 사항):

변수

기본값

용도

BHOONIDHI_MCP_GEOCODER_USER_AGENT

bhoonidhi-mcp/0.1

Nominatim으로 전송되는 User-Agent(사용 정책에 설명적인 것을 요구합니다).

BHOONIDHI_MCP_FUZZY_THRESHOLD

88

위성 이름 일치가 확신할 수 있는 점수(0–100)입니다. 이보다 낮으면 에이전트가 확인할 후보가 반환됩니다.

BHOONIDHI_MCP_MAX_RESULTS

50

search_scenes가 인라인으로 반환하는 최대 장면 수.

BHOONIDHI_MCP_DOWNLOAD_ROOT

~/Downloads

모든 다운로드가 <root>/<slug>/ 아래에 쓰는 허용 목록 루트. 에이전트는 임의 경로를 선택할 수 없습니다.

BHOONIDHI_MCP_DOWNLOAD_PARALLEL

4

병렬 다운로드 작업자 수.

BHOONIDHI_MCP_LARGE_DOWNLOAD_MB

500

다운로드의 실시간 바이트 총계(또는 알려진 크기)가 이 값을 넘으면 상태가 크다고 표시하고 에이전트가 인계하거나 독립 실행형 명령을 실행하도록 안내합니다.

BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD

(설정 안 됨)

선택적 헤드리스 로그인. bhd auth login을 선호합니다. 대역 외에서 채우고 절대 커밋하지 마세요.

개발

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

라이선스

MIT — 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