Skip to main content
Glama
imprvhub

mcp-rss-aggregator

by imprvhub

MCP RSS アグリゲータ

鍛冶屋のバッジ

特徴

  • Claude Desktopでお気に入りのRSSフィードの記事を直接読む

  • 既存のフィードサブスクリプションをインポートするための OPML ファイルのサポート

  • フィードをカテゴリ別に整理する

  • すべてのフィードで最新の記事を入手

  • フィードソースまたはカテゴリで記事をフィルタリングする

  • タイトル、スニペット、リンクを含む、適切にフォーマットされた記事のプレゼンテーション

Related MCP server: @kazuph/mcp-pocket

デモ

タイムスタンプをクリックすると、ビデオのそのセクションにジャンプします。

00:00 -サンプルRSSフィードのデモ:リポジトリに含まれるデフォルトの「sample-feeds.opml」ファイルを使用します。このセグメントでは、ClaudeがTechCrunch、The Verge、その他のテクノロジー系出版物などのニュースソースからMCP(Model Context Protocol)を介してニュースコンテンツを処理および表示する様子を紹介します。

01:05 -構成ファイルの編集プロセス: claude_desktop_config.json ファイルにアクセスして変更し、OPML ファイル パス参照をデフォルトのサンプルからカスタマイズされた「my-feeds.opml」ファイルに変更する手順を順を追って説明します。

01:15 -アプリケーションの再起動手順: 変更された OPML ファイル構成の変更を適切にロードして適用するために、Claude デスクトップ アプリケーションを閉じて再度開く必要な手順を示します。

01:25 -カスタムRSSフィードの結果:カスタムOPMLファイルの実装後の結果のデモンストレーション。このセクションでは、Claude Desktopで利用できるようになった、スペイン語コンテンツを含む、拡張され、より多様なニュースソースについて紹介します。

要件

  • Node.js 16以上

  • クロードデスクトップ

  • RSSフィードにアクセスするためのインターネット接続

インストール

手動でインストールする

  1. このリポジトリをクローンまたはダウンロードします:

git clone https://github.com/imprvhub/mcp-rss-aggregator
cd mcp-rss-aggregator
  1. 依存関係をインストールします:

npm install
  1. プロジェクトをビルドします。

npm run build

フィード構成

RSS アグリゲータは、フィード構成に OPML と JSON の両方の形式をサポートしています。

OPMLの使用(推奨)

OPML (Outline Processor Markup Language) は、ほとんどの RSS リーダーがフィード サブスクリプションをエクスポートおよびインポートするために使用する標準形式です。

一般的なフィードを含むサンプルOPMLファイルはpublic/sample-feeds.opmlファイルに含まれています。以下の操作が可能です。

  1. このファイルをそのまま使用してください

  2. 編集して独自のフィードを追加してください

  3. 既存の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 サーバーを実行するには 2 つの方法があります。

オプション1: 手動で実行する

  1. ターミナルまたはコマンドプロンプトを開きます

  2. プロジェクトディレクトリに移動する

  3. サーバーを直接実行します。

node build/index.js

Claude Desktopの使用中は、このターミナルウィンドウを開いたままにしてください。ターミナルを閉じるまでサーバーは稼働し続けます。

オプション 2: Claude Desktop で自動起動 (通常の使用に推奨)

Claude Desktopは、必要に応じてMCPサーバーを自動的に起動できます。設定手順は次のとおりです。

構成

Claude Desktop の構成ファイルは次の場所にあります。

  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows : %APPDATA%\Claude\claude_desktop_config.json

  • Linux : ~/.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 が必要とするときに自動的に起動します。

使用法

  1. 設定を変更した後、Claude Desktopを再起動します。

  2. Claudeでは、 rssコマンドを使用してRSS Aggregator MCPサーバーと対話します。

  3. 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と対話することもできます。クロードはこれらのリクエストを解釈し、適切なコマンドを使用します。

  • 「Hacker Newsの最新ニュースは何ですか?」

  • 「今日のトップテクノロジー記事を見せて」

  • 「プログラミングフィードから最新の記事を取得する」

  • 「すべてのRSSフィードを一覧表示する」

拡張使用例

毎日のニュースブリーフィング

あらゆるソースからニュース速報を入手しましょう:

rss latest --25

これにより、すべてのフィードから最新の 25 件の記事が取得され、最新のニュースの概要を簡単に把握できるようになります。

トップコンテンツの探索

最も重要な記事や人気のある記事を見つけます:

rss top --20

カテゴリーベースの読書

特定のコンテンツ カテゴリに焦点を当てます。

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

実践的なワークフロー

  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 に RSS アグリゲータ ツールが表示されない場合は、次の手順に従ってください。

  • 設定後、Claude Desktopを再起動してください。

  • Claude Desktop のログで MCP 通信エラーがないか確認します。

  • MCP サーバー プロセスが実行されていることを確認します (手動で実行して確認してください)

フィードが読み込まれない

フィードが正しく読み込まれない場合:

  • OPML/JSONファイルが正しくフォーマットされていることを確認してください

  • 設定内のfeedsPathが正しいか確認してください

  • 既知の正常なフィードファイルを使用してサーバーを手動で実行してみてください

貢献

RSSアグリゲーターの改善に向けた貢献を歓迎します!貢献できる方法は次のとおりです。

  1. より多くのフィード形式のサポートを追加する

  2. フィード解析とエラー処理の改善

  3. 記事の視覚化オプションを追加する

  4. 分類とフィルタリング機能の改善

ライセンス

このプロジェクトは、Mozilla Public License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。

関連リンク

Available Tools

1 tool
rssC

Interfaz principal para Hacker News con comandos simplificados

ParametersJSON Schema
NameRequiredDescriptionDefault
commandYesComando a ejecutar (latest, top, best, history, comments)
paramNoParámetro opcional, número precedido por -- (ejemplo: --10, --50)

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It does not indicate whether the tool is read-only, destructive, or any side effects. Only states it is a main interface, which is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, making it concise. However, it is too brief to be effective, lacking key details that would help an agent use the tool correctly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (2 params, no output schema), the description should at least mention the output format or behavior. It omits this, leaving the agent without sufficient context to invoke the tool confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already explains the parameters. The description adds no meaningful semantic details beyond what the schema provides, resulting in a baseline score of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description identifies the resource (Hacker News) and mentions simplified commands, but does not specify the tool's action (e.g., fetch, retrieve, list). It is not a tautology, but it is vague and lacks a clear verb.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool, no prerequisites, and no alternatives mentioned. Since there are no sibling tools, this is less critical, but still missing context for proper usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedrss

TDQS

C2.4/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion between tools.

Naming Consistency2/5

The single tool name 'rss' is vague and does not follow a clear verb_noun or domain-specific pattern, giving little indication of its purpose.

Tool Count1/5

A single tool for an RSS aggregator, especially for Hacker News, is far too few; a typical implementation would require multiple tools for fetching, listing, searching, and managing feeds.

Completeness1/5

The tool surface is severely incomplete; one monolithic tool cannot reasonably cover the full range of operations expected from an RSS aggregator, such as fetching different feeds, searching, or managing subscriptions.

Maintenance

ActivityStale
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers