# GeoMCP

GeoMCP 是面向地球物理科研服务器的安全工具与知识服务平台，让 Codex / AI Agent、人工 CLI 和 Python 脚本共享同一套权限、任务和科学计算接口。

## 当前状态：v0.1（Step 01–10）

已实现：

```text
Permission / Path Sandbox
Workspace / Data Region I/O
Python API + CLI + MCP
Job Manager (SQLite + JSON mirror)
Local CPU Executor
Fixed-endpoint Remote GPU Executor
GPU Worker Registry
DAS Basic (DASPy)
```

当前 MCP 工具：

```text
system.status
filesystem.inspect
workspace.list
job.list
job.status
job.result
job.cancel
job.submit_healthcheck
das.inspect
das.read_window
das.bandpass
das.rms
das.plot
```

## v0.1 封板状态

Step 10.1 Hardening 已补齐：CI 全量 DAS 依赖、SQLite 原子 Job 状态转换、dispatch watchdog、MCP 固定配置边界、CPU/GPU healthcheck 闭环、DASPy 真正按 channel/sample 窗口读取，以及 MCP DAS 窗口结果压缩。

在此基础上加入 Workspace / Data Region：Agent 可以选择管理员配置的科研区域并使用相对输入/输出路径，但 Workspace 不能扩大全局 Path Sandbox。

MCP 不接受 `config_dir`、host、port、username、command 或任意 task type。

## 安装

基础 CLI / Python API：

```bash
python -m pip install -e .
```

MCP：

```bash
python -m pip install -e ".[mcp]"
```

DASPy 支持：

```bash
python -m pip install -e ".[das]"
```

开发与完整 v0.1：

```bash
python -m pip install -e ".[test,mcp,das]"
pytest -q
```

## 安全边界

- `/cluster/datapool2/xuxy/**` 默认可读
- 仅 GeoMCP `runtime/outputs/knowledge` 默认可写
- 原始科研数据默认只读
- Agent 可通过 Workspace 使用相对输入/输出路径，但 Workspace 不能扩大全局 Path Sandbox
- 不暴露 delete、任意 Shell、任意 SSH
- GPU endpoint 只能由服务器配置指定，Agent 不能传 host/port/user/command
- Worker 只执行 Registry 白名单任务
- DAS 大窗口和超过 Nyquist 的滤波会被拒绝

1012 作为控制侧；GPU Executor 默认关闭，配置固定 endpoint 后由 1012 把 Job ID 转发给 1015 Worker。

## 文档

- [文档总览](docs/README.md)
- [基础使用指南](docs/getting-started/USAGE.md)
- [Workspace / Data Region](docs/architecture/WORKSPACES.md)
- [新增工具开发指南](docs/development/TOOL_DEVELOPMENT.md)
- [开发路线图](docs/development/ROADMAP.md)
- [离线服务器部署](docs/deployment/OFFLINE_SERVER_DEPLOYMENT.md)