Metadata-Version: 2.4
Name: eo-osint-brief-mcp
Version: 0.1.2
Summary: 위성관측(Earth Observation) 기반 OSINT 브리핑 MCP 서버 — 토픽/지역 한 번 입력으로 공개 EO 데이터와 위성영상 기반 매체 보도를 수집·구조화해 브리핑·지도·지식그래프를 반환
Author-email: Juyoung Kim <CHANGE_ME@example.com>
License: MIT
Project-URL: Homepage, https://pypi.org/project/eo-osint-brief-mcp/
Keywords: mcp,osint,remote-sensing,earth-observation,satellite,claude
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2
Requires-Dist: requests>=2.28
Requires-Dist: feedparser>=6.0
Requires-Dist: matplotlib>=3.6
Requires-Dist: networkx>=3.0
Requires-Dist: truststore>=0.9
Dynamic: license-file

# eo-osint-brief-mcp

🛰️ **위성관측(Earth Observation) 기반 OSINT 브리핑 MCP 서버**

토픽이나 지역을 한 번 입력하면, 공개된 위성관측 데이터와 위성영상 기반 매체 보도를
모아 **브리핑 텍스트 + 이벤트 지도 + 지식그래프**를 한 번에 돌려준다.
모든 데이터 소스는 **무인증(인증·API 키 불필요)**.

> 예) Claude Desktop에서
> *"오늘 전 지구에서 위성으로 관측된 이벤트 정리해줘"*
> *"한반도 주변 위성관측 상황 브리핑해줘"*
> *"우크라이나 상황을 위성관측 관점에서 정리해줘"*

## 도구 (1개)

### `eo_osint_brief(topic_or_region: str, days: int = 3)`
단일 호출로 내부 파이프라인을 모두 수행한다:

1. **수집** — NASA EONET(자연이벤트)·USGS(지진)·GDACS(재해경보)·EO뉴스 RSS
2. **정규화·교차검증** — 하나의 Event 스키마로 통일, 현상별 관측 센서 귀속,
   2개 이상 독립 소스로 확인되면 신뢰도 *높음*
3. **렌더** — 이벤트 지도(PNG) + 지식그래프(Event→도메인·센서·출처, PNG)
4. **반환** — 브리핑 텍스트 + 지도 + 지식그래프(콘텐츠 블록 3개)

## 데이터 소스 (모두 무인증)

| 소스 | 내용 |
| --- | --- |
| NASA EONET v3 | 위성 관측 자연이벤트(산불·폭풍·화산·빙하 등) |
| USGS FDSN | 지진(규모·위치) |
| GDACS | 전 지구 재해경보(심각도) |
| EO·OSINT 뉴스 RSS | NASA Earth Observatory, ESA, Bellingcat, SkyTruth |

> FIRMS(위성 화재탐지)는 무료지만 MAP_KEY 등록이 필요해 기본 비활성. 필요 시 확장 가능.

## 설치

```bash
pip install eo-osint-brief-mcp
```

## Claude Desktop 연결

`claude_desktop_config.json` 에 추가:

```json
{
  "mcpServers": {
    "eo-osint-brief": {
      "command": "uvx",
      "args": ["eo-osint-brief-mcp"]
    }
  }
}
```

`uvx` 가 없으면 로컬 파이썬으로:

```json
{
  "mcpServers": {
    "eo-osint-brief": {
      "command": "python",
      "args": ["-m", "eo_osint_brief_mcp"]
    }
  }
}
```

설정 파일 위치
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

저장 후 Claude Desktop을 재시작하면 도구가 활성화된다.

## 아키텍처 메모

MCP 서버는 **공개 EO 데이터를 가져와 구조화하는 도구**만 제공한다.
요약·서술은 호스트(Claude Desktop)가 반환된 데이터로 수행한다 — 서버는 LLM을 호출하지 않는다.
한글 표시는 동봉한 NanumGothic(OFL)을 명시 등록하므로 OS와 무관하게 깨지지 않는다.

## 면책

공개 EO 데이터와 위성영상 기반 매체 보도를 기계적으로 집계한다.
센서 귀속은 "해당 현상을 통상 관측하는 EO 플랫폼" 표기이며 개별 이벤트의 촬영 위성을
단정하지 않는다. 분쟁 관련 항목은 출처 보도를 중립적으로 나열한다.

## License
MIT (동봉 NanumGothic 글꼴은 SIL OFL 1.1)
