┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Data Sources  │    │   MCP Server    │    │   AI Assistant  │
│                 │    │                 │    │                 │
│ • 네이버 뉴스   │────▶│ • 수집 엔진     │◀───│ • Claude        │
│ • 다음 뉴스     │    │ • 분석 엔진     │    │ • ChatGPT       │
│ • RSS 피드      │    │ • REST API      │    │ • 기타          │
│ • 빅카인즈      │    │ • WebSocket     │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

# 1. 저장소 클론
git clone https://github.com/YOUR_USERNAME/mcp-news-collector.git
cd mcp-news-collector

# 2. 가상환경 생성 및 활성화
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. 의존성 설치
pip install -e .

# 4. 환경변수 설정
cp .env.example .env
# .env 파일을 편집하여 데이터베이스 및 API 설정

# 5. 데이터베이스 마이그레이션
alembic upgrade head

# 6. 서버 실행
python -m src.server.main

from mcp import Client

# MCP 서버 연결
client = Client("stdio", ["python", "-m", "src.server.main"])

# 뉴스 수집
result = await client.call_tool("get_recent_news", {
    "keyword": "삼성전자",
    "limit": 10
})

# 뉴스 조회
GET /api/v1/news?query=삼성전자&limit=10

# 감정 분석
POST /api/v1/analysis/sentiment
{
  "news_ids": ["news_1", "news_2"],
  "options": {"include_confidence": true}
}

# 실시간 모니터링 상태
GET /api/v1/monitoring/status

# 전체 테스트 실행
pytest

# 특정 모듈 테스트
pytest tests/unit/test_sentiment_analyzer.py

# 커버리지 확인
pytest --cov=src --cov-report=html

mcp-news-collector/
├── src/                    # 메인 소스 코드
│   ├── analysis/          # 분석 엔진 (감정, 영향도, 루머 탐지 등)
│   ├── collectors/        # 뉴스 수집기 (네이버, 다음, RSS)
│   ├── monitoring/        # 실시간 모니터링 시스템
│   ├── server/            # MCP 서버 및 REST API
│   └── utils/             # 공통 유틸리티
├── tests/                 # 테스트 코드
│   ├── unit/              # 단위 테스트
│   └── integration/       # 통합 테스트
├── docs/                  # 문서
├── configs/               # 설정 파일
└── scripts/               # 유틸리티 스크립트

# 코드 포맷팅
black src/ tests/

# 타입 체킹
mypy src/

# 린팅
pylint src/

# 보안 스캔
bandit -r src/