Metadata-Version: 2.4
Name: korea-eo-osint-mcp
Version: 0.4.6
Summary: 위성영상 기반 한반도 EO-OSINT 분석기 — NASA GIBS 무인증 위성영상 위에 공개 위성/지진/재난/뉴스 소스를 온톨로지 추론으로 구조화하는 MCP 서버
Project-URL: Homepage, https://pypi.org/project/korea-eo-osint-mcp/
Author-email: Juyoung Kim <CHANGE_ME@example.com>
License: MIT
License-File: LICENSE
Keywords: earth-observation,firms,korea,mcp,osint,remote-sensing,satellite
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.2.0
Requires-Dist: pillow>=9.0
Requires-Dist: truststore>=0.8
Description-Content-Type: text/markdown

# korea-eo-osint-mcp

**위성영상 기반 한반도 EO-OSINT 분석기** — NASA GIBS의 **무인증 실제 위성영상**(VIIRS 트루컬러 등)
위에 공개·무인증 위성/지진/재난/뉴스 소스를 수집·오버레이하고, 온톨로지 추론 3규칙으로
신뢰도 등급별 **구조화 분석**을 수행하는 MCP 서버.
질문 한 번에 **위성영상 다크 대시보드(현황) + 신뢰도 패널(결과) + 지식그래프**를 돌려준다.

> 지도 배경 자체가 실제 위성영상이고, 그 위에 OSINT 이벤트가 얹힌다. 각 이벤트는 위성
> 관측 산출물(FIRMS 열원 등)과 공개 보도로 교차검증되며, 최고신뢰 이벤트는 **실제 위성영상 칩**으로 제시된다.
> 방법론은 [onto-osint](https://github.com/aifactory-team/onto-osint-for-2026-iran-war)의
> 엔티티/트리플/신뢰도 계산을 EO 도메인으로 경량 이식했다.

## 위성영상 활용 (NASA GIBS / Worldview, 무인증)

| 용도 | 내용 |
|---|---|
| **지도 배경** | VIIRS 트루컬러 실영상을 권역 bbox로 받아 지도 배경으로 사용(이벤트 오버레이) |
| **이벤트 영상칩** | 최고신뢰 이벤트 위치(±0.45°)의 실제 위성영상 칩을 상세 카드에 표시 |
| **EO 영상 레이어** | 트루컬러 / SWIR 7-2-1(연소흔) / 열이상 375m / 야간조도 DNB 산출물 |
| **확장성** | 동일 파이프라인에 고해상 NEONSAT 영상 등 사내 영상소스 연계 가능 |



## 도구

```
korea_eo_osint(region="한반도", days=7, domain="all")
```

| 인자 | 값 | 설명 |
|---|---|---|
| `region` | 한반도 / 서해 / 동해 / 남해 / 수도권 / 접경 | 분석 권역(폴리곤 GeoFocus) |
| `days` | 1–7 | 조회 기간(일) |
| `domain` | all / disaster / defense | 도메인 필터 |

반환: ① 신뢰도 등급별 브리핑(텍스트) ② 대시보드 지도(PNG) ③ 지식그래프(PNG).

## 추론 3규칙

1. **다중소스 교차검증 → 신뢰도 등급** — 같은 현상을 잡은 독립 소스/위성이 많을수록
   신뢰도 상승(noisy-OR `1 − Π(1−rᵢ)`). 등급: 높음 / 보통 / 미검증.
   예) 화재를 위성 3개가 동시 탐지 → 신뢰도 1.00 "높음".
2. **센서–현상 적합성** — 현상별로 어떤 센서가 적합한지 고정 매핑(열원=VIIRS/MODIS TIR,
   홍수=SAR 구름투과 등). 적합 센서를 라벨로 표기.
3. **한반도 GeoFocus** — 권역별 폴리곤 + ray-casting 내부 판정으로 일본 규슈·중국 산둥
   누수를 제거. 접경/연안 이벤트는 우선순위 가산.

## 무인증 소스

- **NASA GIBS / Worldview** — 실제 위성영상(VIIRS 트루컬러/SWIR/열이상/야간조도). 지도 배경·영상칩
- **FIRMS** active fire 직접 CSV — VIIRS S-NPP / VIIRS NOAA-20 / MODIS (열원)
- **USGS** FDSN event query — 한반도 bbox + 기간 (지진)
- **GDACS** event list — 한반도 주변 재난
- **뉴스 RSS** — CSIS Beyond Parallel / 38 North / Bellingcat(키워드) / Google News(한글 다중 쿼리)

모든 소스는 **API 키 불필요**. 사내망 SSL 검사 환경은 `truststore`로 OS 신뢰저장소를
주입하며, 잠긴 환경은 `EO_OSINT_VERIFY=0`으로 검증을 우회할 수 있다.

## 설치 & Claude Desktop 연결

```bash
# PyPI 배포 후
uv tool install korea-eo-osint-mcp        # 또는: pipx install korea-eo-osint-mcp
```

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "korea-eo-osint": {
      "command": "uvx",
      "args": ["korea-eo-osint-mcp"],
      "env": { "EO_OSINT_VERIFY": "1" }
    }
  }
}
```

Claude Desktop에서 "**한반도 최근 7일 열원/재난 현황 분석해줘**"처럼 물으면 도구가 호출된다.

## 안전선

공개·관측 가능한 사실까지만 다룬다. 군사 정밀좌표·작전적 추론은 생성하지 않으며,
출처를 중립적으로 나열한다.

## 라이선스

MIT
