MCP News Server

news-mcp MCP 서버

mcp 뉴스 서버

구성 요소

자원

서버는 리소스 URI를 통해 데이터베이스에 저장된 뉴스 기사를 노출합니다.

• news://{category}/{limit} : 주어진 카테고리의 최신 기사 목록을 검색합니다.
  • {category} : 카테고리(예: tech , data_science , news )별로 기사를 필터링합니다. 전체 목록은 도구 설명을 참조하세요.
  • {limit} (선택 사항, 기본값 10): 반환할 기사의 최대 수를 지정합니다.
• 반환된 각 기사에는 제목, 링크, 게시 날짜, 출처가 포함되어 있습니다.

프롬프트

현재 서버는 어떤 프롬프트도 노출하지 않습니다. (요약 로직은 내부적으로 존재하지만 MCP 프롬프트를 통해 사용할 수 없습니다.)

도구

서버는 하나의 도구를 구현합니다.

• summarize_news : 데이터베이스에서 원시 뉴스 기사를 검색하여 클라이언트(LLM)가 이를 요약할 수 있도록 합니다.
  • 선택적인 category (문자열) 및 limit (정수, 기본값 20) 인수를 사용합니다.
  • id , title , link , published , source , content 각각 포함하는 기사 사전 목록을 반환합니다.
  • 사용 가능한 카테고리: tech , data_science , llm_tools , cybersecurity , linux , audio_dsp , startups , news , science , research , policy .

구성

서버는 DATABASE_URL 환경 변수를 통해 구성된 PostgreSQL 데이터베이스를 사용합니다(기본값은 postgresql://localhost/mcp_news ).

news_gatherer.py 스크립트(별도로 실행되거나 예약되도록 설계됨)는 다양한 RSS 피드에서 데이터베이스를 채웁니다.

요약 논리(내부적, MCP를 통해 공개되지 않음)는 OPENAI_API_KEY 환경 변수를 통해 구성된 OpenAI API를 사용합니다.

기타 구성(환경 변수 또는 기본값을 통해):

• LOOKBACK_HOURS : news_gatherer.py 새로운 기사를 찾는 시점까지의 시간(기본값: 6).
• SUMMARY_WORD_TARGET : 내부 요약을 위한 목표 단어 수(기본값: 500).
• MAX_ARTICLES_PER_SUMMARY : 한 요약 배치에 포함되는 최대 기사 수(기본값: 25).
• KEYWORD_FILTER : 내부 요약 논리에서 사용되는 키워드입니다.

빠른 시작

설치하다

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

지엑스피1

2. 패키지 배포 빌드:

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN
• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.