用途
bhoonidhi-mcp 是一个 MCP（Model Context Protocol）服务器，让 AI 智能体用自然语言搜索、保存、下载和加入购物车 ISRO 的 Bhoonidhi Browse & Order 门户（NRSC）卫星影像。智能体可以把“Sentinel-2 over Shillong last January”这样的句子转化为对实时门户的真实搜索，查看实际可下载的内容，保存搜索以便复用，预览下载会获取什么，并在登录后下载开放数据影像或将其加入购物车。
它是 bhoonidhi-downloader SDK 的轻量适配层——与 bhd CLI 使用同一客户端，因此不重复实现门户逻辑。
主要能力
- 搜索与保存无需登录；下载和加入购物车需要登录。
- 工具可访问 41 个卫星任务和 79 个传感器的完整档案，搜索实时门户，并将搜索保存为可复用的 slug——全部无需凭据。
- 下载开放数据影像和将影像加入 Bhoonidhi 购物车需要登录，通过 bhd auth login 在带外完成（服务器复用该会话）。
- 可用性区分：OpenData 影像不一定已准备好下载。search_scenes 和 preview_download 区分 Ready（可立即获取）与 Archived（开放数据，但可能需先在门户请求），避免智能体过度承诺。
- 下载在后台运行，独立于对话：download_query 立即返回 job_id，传输自行进行。可用 download_status 查看一次进度（已下载字节数、传输速率、已知大小时显示百分比），或用 download_wait 跟随任务直至完成（或达到上限超时），让智能体可以委托后台监视器而不必 sleep 循环。任务仅在服务器进程存活期间存在，因此当下载被证明很大时，状态会建议改用独立的 bhd query download <slug> 命令。
使用方式
该服务器是一个 Python 包，带控制台入口点 bhoonidhi-mcp。最简单的运行方式是使用 uv——uvx 直接从源码获取、构建并启动，无需克隆或虚拟环境。首次运行从源码构建，之后从缓存启动。服务器使用 stdio，由 MCP 客户端启动——将客户端指向该命令即可。
如需本地检出（用于开发），克隆并 uv sync，然后使用 .venv/bin/bhoonidhi-mcp 作为命令。
连接客户端：每个 MCP 客户端都需要相同的启动命令。将其指向 uvx，并将源码和入口点作为参数。
- Claude Desktop / Claude Code：claude_desktop_config.json（或 claude mcp add）
- ~/.config/opencode/opencode.json
- MCP Inspector（无需智能体即可试用）
登录（用于下载和购物车）：搜索、保存查询和预览无需凭据。下载影像和加入购物车需要。带外登录一次——服务器复用 bhd CLI 写入的同一会话。MCP 服务器从不将用户名或密码作为工具参数，auth_status 也从不返回令牌。对于无交互登录的无头设置，可在服务器环境中设置 BHOONIDHI_USERNAME / BHOONIDHI_PASSWORD；服务器仅用它们建立会话。
适用场景
- 用自然语言发现档案：“Bhoonidhi 有哪些卫星和传感器？”“ResourceSat-2A 携带哪些传感器，分辨率是多少？”“Bhoonidhi 有雷达卫星吗？”
- 搜索影像：“查找 2024 年 1 月 Shillong 上空的 Sentinel-2 影像。”“显示 2024 年上半年 Bengaluru 20 公里内的 Cartosat 影像。”
- 检查可下载性：“这些 Sentinel-2 影像中，有多少现在可以实际下载？”“哪些需要订购或付费？”
- 预览下载、保存搜索以便复用、列出/查看/删除已保存搜索。
- 下载与购物车（需登录）：“我登录 Bhoonidhi 了吗？”“下载我保存的搜索 <slug> 中的开放数据影像。”“下载进行得如何？”“下载 <slug> 并在完成时通知我。”“将 <slug> 中的付费影像加入购物车。”“本周我的购物车里有什么？”
限制
- 下载开放数据影像和加入购物车需要登录；搜索、保存查询和预览无需凭据。
- 下载任务仅在服务器进程存活期间存在；大文件下载建议改用独立的 bhd 命令。
- 付费和订购影像仅加入购物车，服务器从不绕过支付；订单和支付需在 Bhoonidhi 完成。
- 通过本服务器获取的影像属于 ISRO/NRSC，受 Bhoonidhi EULA 约束，而非本项目的 MIT 许可证。EULA 要求：使用自己的账户；发布时注明来源 ISRO-IRS；不得转售原始数据（开放数据可免费使用、发布和构建，但原始产品不得以原始形式商业再分发，衍生和增值产品可以）；付费和订购影像通过门户处理。
- 本项目代码采用 MIT 许可证。
