mcp-rss-aggregator

MCP RSS 애그리게이터

Claude Desktop이 MCP(Model Context Protocol)를 사용하여 사용자가 좋아하는 RSS 피드에서 콘텐츠를 가져와서 읽을 수 있도록 하는 통합입니다.

특징

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

요구 사항

• Node.js 16 이상
• 클로드 데스크탑
• RSS 피드에 접속하려면 인터넷에 연결해야 합니다.

설치

수동 설치

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

지엑스피1

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

피드 구성

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

OPML 사용(권장)

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

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

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

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

JSON 사용하기

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

MCP 서버 실행

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

옵션 1: 수동 실행

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

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 구성을 추가하세요. 파일이 없으면 새로 만드세요.

중요 참고 사항 :

• 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" 섹션을 추가하기만 하면 됩니다.

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

용법

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

사용 가능한 명령

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

사용 예

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

직접 명령:

자연어 쿼리:

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

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

확장된 사용 예

일간 뉴스 브리핑

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

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

인기 콘텐츠 탐색

가장 중요하거나 인기 있는 기사를 찾아보세요:

카테고리 기반 읽기

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

소스별 업데이트

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

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

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

여러 요청 결합

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

실용적인 워크플로

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

클로드와 함께 일하다

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

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

문제 해결

"서버 연결 끊김" 오류

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

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

Claude에 도구가 나타나지 않음

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

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

피드가 로드되지 않습니다

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

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

기여하다

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

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

특허

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

관련 링크

• 모델 컨텍스트 프로토콜
• 클로드 데스크탑