Skip to main content
Glama

bhoonidhi-mcp

License: MIT

AI エージェントが ISRO の Bhoonidhi Browse & Order ポータル(NRSC)の衛星シーンを自然言語で検索・保存・ダウンロード・カート追加できるようにする MCP サーバーです。エージェントは「先月のシロン周辺の 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

地名("Loktak Lake")を重心点とバウンディングボックスに変換します。地名でない入力は拒否します。

不要

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 によるバックグラウンドダウンロードの1回限りの確認です。ダウンロード済みバイト数、転送レート、サイズが判明している場合はパーセント、シーンごとの詳細を報告します。

不要

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

これにより、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

例

エージェントに平易な言葉で尋ねます。

「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