把你的 Agent
接到真实本地数据上。

每一步都能检查的工作流。

给 Agent 一个具体任务，再逐步核对源文件、处理计划和保存结果。下面以支持的本地 Sentinel-2 场景分类层（SCL）为例。

1. 检查源文件与像元

   检查栅格的坐标系、尺寸、校验和与原始像元值，把处理配方绑定到明确的源任务和校验和。

   geod_raster_inspect · geod_raster_pixel

2. 核对像元对齐的裁剪计划

   创建任务前，核对输出尺寸、裁剪范围和警告信息。

   geod_recipe_plan

3. 启用写操作后执行，并等待完成

   写操作需要在启动时明确配置。执行配方后，等待任务成功且工作线程完成收尾。

   geod_recipe_run → geod_job_status
status = succeeded · settled = true

4. 检查已保存的 GeoTIFF 结果

   检查完成的文件并读取样本像元，保持结果与源文件、处理配方的关联。

   geod_raster_inspect · geod_raster_pixel

有实际结果的工具能力。

• 任务与项目

  读取持久化的任务状态与项目记录，跟踪同一项任务直到完成。

  geod_jobs_list · geod_job_status · geod_projects_list
• 栅格检查与处理配方

  读取真实像元，执行前预览支持的处理配方所产生的输出网格。

  geod_raster_inspect · geod_raster_pixel · geod_recipe_plan
• 已保存的 WCS 数据

  检查已保存的覆盖描述、计划，以及已完成本地文件中的原始采样值。

  geod_wcs_plan · geod_wcs_inspect · geod_wcs_pixel
• 明确启用的任务操作

  启用写操作后，可执行支持的配方、下载支持的文件，或取消和重试任务。

  geod_recipe_run · geod_download · geod_job_cancel

两种接入方式。

使用从源码构建的开发运行时，在兼容的 MCP 客户端中配置可执行文件路径，再选择一种连接模式。

连接已运行的本地服务

先启动本地 GeoD 服务，再连接其回环地址。任务由服务管理，因此 Agent 会话关闭后仍可继续。

geod-runtime serve-mcp --server http://127.0.0.1:4318

使用独立的本地工作区

独立 MCP 进程独占自己的数据目录。使用未被桌面应用或其他进程占用的目录，并保持会话直到任务收尾完成。

geod-runtime serve-mcp --data-dir ./geod-agent-data

只有需要启用写操作时，才添加下面的启动参数。

--allow-write

通过兼容客户端中的本地 MCP 适配器接入，调用 GeoD 运行时；不会自动控制已打开的桌面窗口。