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. 프로젝트 클론 및 의존성 설치

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

2. 환경 변수 설정

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

cp .env.example .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. 빌드

npm run build

Claude Desktop에서 사용하기

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

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.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 파일을 사용하는 경우:

{
  "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. 조합 사용:

   "오늘의 헤드라인을 가져와서 첫 번째 뉴스의 상세 정보를 한국어로 번역해줘"

개발

개발 모드로 실행:

npm run dev

Watch 모드 (자동 재빌드):

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을 완전히 재시작하세요