mcp-rss-애그리게이터

MCP RSS 애그리게이터

특징

Claude Desktop에서 좋아하는 RSS 피드의 기사를 직접 읽어보세요.
기존 피드 구독을 가져오기 위한 OPML 파일 지원
카테고리별로 피드 구성
모든 피드에서 최신 기사를 받아보세요
피드 소스 또는 카테고리별로 기사 필터링
제목, 스니펫, 링크가 포함된 잘 구성된 기사 프레젠테이션

데모

비디오의 해당 섹션으로 이동하려면 타임스탬프를 클릭하세요.

00:00 - 샘플 RSS 피드 데모 : 저장소에 포함된 기본 'sample-feeds.opml' 파일을 사용합니다. 이 세그먼트는 Claude가 TechCrunch, The Verge 및 기타 기술 관련 출판물의 뉴스 콘텐츠를 MCP(모델 컨텍스트 프로토콜)를 통해 처리하고 표시하는 방법을 보여줍니다.

01:05 - 구성 파일 편집 프로세스 : claude_desktop_config.json 파일에 접근하고 수정하여 OPML 파일 경로 참조를 기본 샘플에서 사용자 지정 'my-feeds.opml' 파일로 변경하는 단계별 연습입니다.

01:15 - 애플리케이션 재시작 절차 : 수정된 OPML 파일 구성 변경 사항을 제대로 로드하고 적용하기 위해 Claude Desktop 애플리케이션을 닫고 다시 여는 데 필요한 단계를 보여줍니다.

01:25 - 사용자 지정 RSS 피드 결과 : 사용자 지정 OPML 파일 구현 후 결과 시연. 이 섹션에서는 Claude Desktop을 통해 제공되는 더욱 확장되고 다양해진 뉴스 소스(스페인어 콘텐츠 포함)를 소개합니다.

요구 사항

Node.js 16 이상
클로드 데스크탑
RSS 피드에 접속하기 위한 인터넷 연결

설치

수동 설치

이 저장소를 복제하거나 다운로드하세요:

지엑스피1

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

피드 구성

RSS Aggregator는 피드 구성을 위해 OPML과 JSON 형식을 모두 지원합니다.

OPML 사용(권장)

OPML(Outline Processor Markup Language)은 대부분의 RSS 리더에서 피드 구독을 내보내고 가져오는 데 사용되는 표준 형식입니다.

인기 피드가 포함된 샘플 OPML 파일은 public/sample-feeds.opml 파일에 포함되어 있습니다. 다음 작업을 수행할 수 있습니다.

이 파일을 그대로 사용하세요
자신의 피드를 추가하려면 편집하세요.
기존 RSS 리더에서 내보낸 파일로 교체하세요.

대부분의 RSS 리더에서는 구독 내용을 OPML 파일로 내보낼 수 있습니다.

JSON 사용하기

또는 다음 형식의 JSON 파일로 피드를 정의할 수 있습니다.

[
  {
    "title": "Hacker News",
    "url": "https://news.ycombinator.com/rss",
    "htmlUrl": "https://news.ycombinator.com/",
    "category": "Tech News"
  },
  {
    "title": "TechCrunch",
    "url": "https://techcrunch.com/feed/",
    "htmlUrl": "https://techcrunch.com/",
    "category": "Tech News"
  }
]

MCP 서버 실행

MCP 서버를 실행하는 방법은 두 가지가 있습니다.

옵션 1: 수동 실행

터미널이나 명령 프롬프트를 엽니다
프로젝트 디렉토리로 이동합니다
서버를 직접 실행합니다.

node build/index.js

Claude Desktop을 사용하는 동안 이 터미널 창을 열어 두세요. 터미널을 닫을 때까지 서버가 실행됩니다.

옵션 2: Claude Desktop으로 자동 시작(일반 사용 시 권장)

Claude Desktop은 필요 시 MCP 서버를 자동으로 시작할 수 있습니다. 설정 방법은 다음과 같습니다.

구성

Claude Desktop 구성 파일은 다음 위치에 있습니다.

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우 : %APPDATA%\Claude\claude_desktop_config.json
리눅스 : ~/.config/Claude/claude_desktop_config.json

이 파일을 편집하여 RSS Aggregator MCP 구성을 추가하세요. 파일이 없으면 새로 만드세요.

{
  "mcpServers": {
    "rssAggregator": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"],
      "feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"
    }
  }
}

중요 참고 사항 :

ABSOLUTE_PATH_TO_DIRECTORY MCP를 설치한 전체 절대 경로 로 바꾸세요.
- macOS/Linux 예: /Users/username/mcp-rss-aggregator
- Windows 예: C:\\Users\\username\\mcp-rss-aggregator
ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml OPML 또는 JSON 파일 경로로 바꾸세요.
- 생략하면 샘플 피드 파일이 사용됩니다.

이미 다른 MCP를 구성한 경우 "mcpServers" 개체 내부에 "rssAggregator" 섹션을 추가하기만 하면 됩니다.

{
  "mcpServers": {
    "otherMcp1": {
      "command": "...",
      "args": ["..."]
    },
    "rssAggregator": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"
      ],
      "feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"
    }
  }
}

MCP 서버는 claude_desktop_config.json 파일의 구성에 따라 Claude Desktop에 필요할 때 자동으로 시작됩니다.

용법

구성을 수정한 후 Claude Desktop을 다시 시작하세요.
Claude에서 rss 명령을 사용하여 RSS Aggregator MCP 서버와 상호 작용합니다.
MCP 서버는 Claude Desktop이 관리하는 하위 프로세스로 실행됩니다.

사용 가능한 명령

RSS Aggregator MCP는 여러 명령을 포함하는 rss 라는 도구를 제공합니다.

명령	설명	매개변수	예
`latest`	모든 피드의 최신 기사 표시	선택적 제한(--N)	`rss latest --20`
`top` 또는 `best`	모든 피드의 인기 기사 표시	선택적 제한(--N)	`rss top --15`
`list`	사용 가능한 모든 피드 나열	없음	`rss list`
`--[feed-id]`	특정 피드의 기사 표시	선택적 제한(--N)	`rss --hackernews --10`
`[category]`	특정 카테고리의 기사 보기	선택적 제한(--N)	`rss "Tech News" --20`
`set-feeds-path --[path]`	OPML/JSON 파일 경로 설정	파일 경로	`rss set-feeds-path --/path/to/feeds.opml`

사용 예

다음은 Claude와 함께 RSS Aggregator를 사용하는 방법에 대한 다양한 예입니다.

직접 명령:

rss latest
rss top --20
rss list
rss "Tech News"
rss --hackernews
rss --techcrunch --15

자연어 쿼리:

자연어를 사용하여 MCP와 상호 작용할 수도 있습니다. Claude는 이러한 요청을 해석하고 적절한 명령을 사용합니다.

"해커 뉴스의 최신 소식은 무엇인가요?"
"오늘의 인기 기술 기사를 보여주세요"
"내 프로그래밍 피드에서 최신 기사를 가져옵니다"
"내 RSS 피드 모두 나열"

확장된 사용 예

일간 뉴스 브리핑

모든 소식통에서 뉴스 브리핑을 받아보세요.

rss latest --25

이렇게 하면 모든 피드에서 가장 최근의 기사 25개가 표시되어 최신 뉴스를 빠르게 살펴볼 수 있습니다.

카테고리 기반 읽기

특정 콘텐츠 카테고리에 집중하세요:

rss "Tech News" --30
rss "Politics" --15
rss "Science" --10

소스별 업데이트

팔로우하는 특정 출처의 업데이트를 읽어보세요:

rss --hackernews --20
rss --nytimes
rss --techcrunch --15

사용 가능한 피드를 찾아보세요

어떤 피드를 구성했는지 확인하세요.

rss list

여러 요청 결합

포괄적인 뷰를 구축하기 위해 여러 개의 순차적 요청을 만들 수 있습니다.

rss "Tech News" --10
rss "Finance" --10
rss top --5

실용적인 워크플로

아침 루틴 :
rss top --10 rss "News" --5
산업 연구 :
rss "Industry News" --15 rss --bloomberg --5
기술 업데이트 :
rss --hackernews --10 rss --techcrunch --5

클로드와 함께 일하다

Claude에게 기사를 분석하거나 요약해 달라고 요청할 수 있습니다.

실행 후: rss latest --10 질문: "이 기사들을 요약해 주실 수 있나요?"
실행 후: rss "Tech News" --15 질문: "이 기술 기사의 주요 동향은 무엇입니까?"
실행 후: rss --nytimes --washingtonpost --10 질문: "이러한 소스가 현재 이벤트를 어떻게 다루는지 비교해 보세요"

문제 해결

"서버 연결 끊김" 오류

Claude Desktop에서 "MCP RSS Aggregator: 서버 연결 끊김" 오류가 표시되는 경우:

서버가 실행 중인지 확인하세요 .
- 터미널을 열고 프로젝트 디렉토리에서 node build/index.js 수동으로 실행하세요.
- 서버가 성공적으로 시작되면 이 터미널을 열어둔 채로 Claude를 사용하세요.
구성을 확인하세요 :
- claude_desktop_config.json 의 절대 경로가 시스템에 맞는지 확인하세요.
- Windows 경로에 이중 백슬래시( \\ )를 사용했는지 다시 한 번 확인하세요.
- 파일 시스템의 루트에서 전체 경로를 사용하고 있는지 확인하세요.

Claude에 도구가 나타나지 않음

Claude에 RSS Aggregator 도구가 나타나지 않는 경우:

구성 후 Claude Desktop을 다시 시작했는지 확인하세요.
MCP 통신 오류가 있는지 Claude Desktop 로그를 확인하세요.
MCP 서버 프로세스가 실행 중인지 확인하세요(확인하려면 수동으로 실행하세요)

피드가 로드되지 않습니다

피드가 제대로 로드되지 않는 경우:

OPML/JSON 파일이 올바르게 포맷되었는지 확인하세요.
구성의 feedsPath 가 올바른지 확인하세요.
알려진 좋은 피드 파일을 사용하여 서버를 수동으로 실행해보세요.

기여하다

RSS 애그리게이터 개선을 위한 여러분의 참여를 환영합니다! 다음과 같은 방법으로 참여하실 수 있습니다.

더 많은 피드 형식에 대한 지원 추가
피드 구문 분석 및 오류 처리 개선
기사에 대한 시각화 옵션을 더 추가하세요
분류 및 필터링 기능 개선

특허

이 프로젝트는 Mozilla Public License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.