# MCP News Server

뉴스 헤드라인을 가져오고, 요약하고, 한국어로 번역하는 Model Context Protocol (MCP) 서버입니다.

## 기능

이 MCP 서버는 다음 4가지 도구를 제공합니다:

### 1. `get_top_headlines`
미국의 상위 10개 뉴스 헤드라인을 가져옵니다.
- **파라미터**: 
  - `category` (선택): business, entertainment, general, health, science, sports, technology
- **반환값**: 제목, 출처, 발행 시간

### 2. `get_news_details`
특정 뉴스 기사의 상세 정보를 가져옵니다.
- **파라미터**: 
  - `title` (필수): 뉴스 기사의 정확한 제목
- **반환값**: 제목, 출처, 발행 시간, 설명, URL, 작성자

### 3. `summarize_news`
AI를 사용하여 뉴스 기사를 요약합니다.
- **파라미터**: 
  - `text` (필수): 요약할 뉴스 텍스트
  - `maxLength` (선택): 요약 최대 단어 수 (기본값: 100)
- **반환값**: 요약된 텍스트

### 4. `translate_to_korean`
영어 뉴스 텍스트를 고품질 한국어로 번역합니다.
- **파라미터**: 
  - `text` (필수): 번역할 영어 텍스트
- **반환값**: 한국어 번역

## 설치 방법

### 1. 프로젝트 클론 및 의존성 설치

```bash
cd c:\Users\ekfak\git-repositories\ai\mcp-news-server
npm install
```

### 2. 환경 변수 설정

`.env.example` 파일을 `.env`로 복사하고 API 키를 설정합니다:

```bash
cp .env.example .env
```

`.env` 파일을 열고 다음 값을 설정하세요:

```env
# News API Key - https://newsapi.org/에서 무료로 발급받을 수 있습니다
NEWS_API_KEY=your_actual_news_api_key

# OpenAI API Key - https://platform.openai.com/api-keys에서 발급받을 수 있습니다
OPENAI_API_KEY=your_actual_openai_api_key
```

#### API 키 발급 방법:

**News API:**
1. https://newsapi.org/ 방문
2. "Get API Key" 클릭하여 무료 계정 생성
3. API 키 복사

**OpenAI API:**
1. https://platform.openai.com/ 방문
2. 계정 생성 또는 로그인
3. API Keys 섹션에서 새 키 생성
4. API 키 복사

### 3. 빌드

```bash
npm run build
```

## Claude Desktop에서 사용하기

Claude Desktop 설정 파일에 다음을 추가합니다:

**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "mcp-news-server": {
      "command": "node",
      "args": ["c:\\Users\\ekfak\\git-repositories\\ai\\mcp-news-server\\dist\\index.js"],
      "env": {
        "NEWS_API_KEY": "your_news_api_key",
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}
```

또는 `.env` 파일을 사용하는 경우:

```json
{
  "mcpServers": {
    "mcp-news-server": {
      "command": "node",
      "args": ["c:\\Users\\ekfak\\git-repositories\\ai\\mcp-news-server\\dist\\index.js"],
      "cwd": "c:\\Users\\ekfak\\git-repositories\\ai\\mcp-news-server"
    }
  }
}
```

설정 후 Claude Desktop을 재시작하세요.

## 사용 예시

Claude Desktop에서 다음과 같이 요청할 수 있습니다:

1. **오늘의 헤드라인 가져오기:**
   > "오늘의 미국 주요 뉴스 헤드라인 10개를 가져와줘"

2. **기술 뉴스 가져오기:**
   > "오늘의 기술 관련 뉴스를 가져와줘"

3. **특정 뉴스 상세 정보:**
   > "첫 번째 뉴스의 상세 정보를 보여줘"

4. **뉴스 요약:**
   > "이 뉴스를 50단어로 요약해줘"

5. **한국어 번역:**
   > "이 뉴스를 한국어로 번역해줘"

6. **조합 사용:**
   > "오늘의 헤드라인을 가져와서 첫 번째 뉴스의 상세 정보를 한국어로 번역해줘"

## 개발

### 개발 모드로 실행:

```bash
npm run dev
```

### Watch 모드 (자동 재빌드):

```bash
npm run watch
```

## 프로젝트 구조

```
mcp-news-server/
├── src/
│   ├── index.ts              # MCP 서버 메인 파일
│   └── tools/
│       ├── fetchNews.ts      # News API 통합
│       ├── summarize.ts      # AI 요약 기능
│       └── translate.ts      # AI 번역 기능
├── dist/                     # 빌드된 파일
├── package.json
├── tsconfig.json
├── .env                      # API 키 (생성 필요)
└── .env.example              # 환경 변수 예시
```

## 기술 스택

- **TypeScript**: 타입 안전성을 위한 주 개발 언어
- **@modelcontextprotocol/sdk**: MCP 프로토콜 구현
- **axios**: HTTP 요청
- **News API**: 뉴스 헤드라인 소스
- **OpenAI GPT-4o-mini**: 요약 및 번역

## 제한 사항

- News API 무료 플랜은 하루 100개의 요청으로 제한됩니다
- News API는 개발자 계정으로는 최신 뉴스만 제공됩니다 (최근 24시간)
- OpenAI API는 사용량에 따라 과금됩니다

## 문제 해결

### "NEWS_API_KEY is required" 오류
- `.env` 파일이 프로젝트 루트에 있는지 확인하세요
- `.env` 파일에 올바른 API 키가 설정되어 있는지 확인하세요

### "Failed to fetch news" 오류
- News API 키가 유효한지 확인하세요
- 하루 요청 제한을 초과하지 않았는지 확인하세요
- 인터넷 연결을 확인하세요

### Claude Desktop에서 서버가 보이지 않음
- `claude_desktop_config.json` 파일 경로가 올바른지 확인하세요
- 빌드가 완료되었는지 확인하세요 (`npm run build`)
- Claude Desktop을 완전히 재시작하세요