newspaper-mcp

Name: newspaper-mcp
Author: AndyTheFactory

Official

LLM 에이전트를 위한 도구로 newspaper4k의 뉴스 기사 발견 및 추출 기능을 노출하는 MCP 서버입니다. 공식 MCP Python SDK v2로 구축되었습니다.

Tools

Tool	Description
`parse_article`	단일 기사 다운로드 및 파싱 (제목, 저자, 본문, 이미지, NLP)
`parse_articles`	여러 기사 URL을 동시에 다운로드하고 파싱
`discover_source`	뉴스 사이트 홈페이지를 크롤링하여 브랜드 정보, 카테고리, 피드, 기사 탐색
`list_source_articles`	소스에서 발견된 기사 URL/제목을 페이지네이션과 함께 나열
`search_news`	키워드/주제/사이트/위치로 Google News 검색 (`gnews` 필요)
`extract_article_text`	원시 HTML 또는 URL에서 텍스트만 빠르게 추출, 메타데이터/NLP 미포함
`analyze_article`	다운로드 + NLP 실행: 점수가 있는 키워드와 추출식 요약 생성
`get_source_categories`	소스의 섹션/카테고리 URL 목록
`get_source_feeds`	소스의 RSS/Atom 피드 URL 나열

이 패키지는 저장소 루트의 로컬 newspaper4k 체크아웃(pyprojecty.toml의 tool.uv.sources를 통해)에 의존하므로, 항상 개발 중인 버전의 라이브러리를 사용합니다.

cd newspaper_mcp
uv sync

uv run newspaper-mcp          # stdio transport (default)
uv run mcp dev src/newspaper_mcp/server.py   # MCP Inspector

MCP 호스트(예: Claude Desktop)에 추가하려면, 호스트가 stdio 서버로 uv run --directory /path/to/newspaper_mcp newspaper_mcp를 가리키게 하세요.

search_news는 선택적인 gnews 패키지가 필요하며, pyproject.toml에 선언된 newspaper4k[gnews] 추가를 통해 이미 포함되어 있습니다.
NLP 기능(nlp(), 키워드 추출, 요약)은 nltk가 필요하며, newspaper4k[nlp] 추가를 통해 받아집니다. 첫 사용 시 nltk가 자체 punkt 토크나이저 데이터를 다운로드해야 할 수 있습니다.
모든 도구는 대상 뉴스 사이트에 실시간 네트워크 요청을 수행하며, 호출 간 캐싱은 없습니다.
모든 도구는 대상 뉴스 사이트에 실시간 네트워크 요청을 수행하며, 호출 간 캐싱은 없습니다.
모든 도구는 대상 뉴스 사이트에 실시간 네트워크 요청을 수행하며, 호출 간 캐싱은 없습니다.

This server cannot be deployed

ActivityStale

ResponsivenessNo issues