RSS Reader MCP Server

RSS Reader MCP サーバー

URL から RSS／Atom フィードを取得して解析する機能を提供する、TypeScript ベースの MCP サーバーです。

概要

この MCP サーバーは、RSS および Atom フィードから構造化データを取得、解析、抽出するツールを提供することで、RSS フィードの読み取り機能を実装します。堅牢なフィード解析には rss-parser ライブラリを、適切なエラー処理とタイムアウトを備えた HTTP リクエストには axios を使用します。

機能

ツール

• get_items - 指定した URL から RSS フィードのアイテムを取得します
  • 入力：RSS フィードの URL（必須）
  • 出力：フィードのメタデータとアイテムを含む構造化 JSON
  • 機能：
    • 10 秒のタイムアウトで RSS／Atom フィードを取得します
    • 標準的な RSS フィールド（title、link、description、pubDate、author など）を解析します
    • カスタムフィールド（メディアコンテンツ、サムネイル、エンコードされたコンテンツ）を抽出します
    • カテゴリと添付ファイルを処理します
    • ネットワークや解析の問題に対する包括的なエラー処理を提供します

対応フィード形式

• RSS 2.0
• RSS 1.0（RDF）
• Atom フィード
• 次のようなカスタムフィールド：
  • メディアコンテンツとサムネイル
  • Dublin Core の作成者フィールド
  • エンコードされたコンテンツのフィールド

エラー処理

• URL の検証
• ネットワークタイムアウトの処理（10 秒）
• HTTP エラーステータスの処理
• RSS 解析エラーの処理
• デバッグに役立つ包括的なエラーメッセージ

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバーの設定を追加します：

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rss-reader-server": {
      "command": "node",
      "args": ["/path/to/rss-reader-server/build/index.js"]
    }
  }
}

使用例

接続したら、get_items ツールを使って RSS フィードのアイテムを取得できます：

Tool: get_items
Input: { "url": "https://example.com/feed.xml" }

サーバーは次の情報を含む構造化 JSON レスポンスを返します：

• フィード URL
• アイテムの合計数
• フィードアイテムの配列。各アイテムには次の情報が含まれます：
  • タイトル、リンク、説明
  • 公開日と作成者
  • カテゴリ（利用可能な場合）
  • 添付ファイルの情報（ポッドキャスト／メディアの場合）

依存関係

• @modelcontextprotocol/sdk：MCP プロトコルの実装
• rss-parser：RSS／Atom フィードの解析
• axios：フィード取得用の HTTP クライアント
• zod：実行時の型検証

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします：

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

エラーレスポンス

このサーバーは、一般的な問題について詳細なエラーメッセージを提供します：

• 無効な URL 形式
• ネットワーク接続の問題
• HTTP エラー（404、500 など）
• リクエストのタイムアウト
• RSS の解析失敗

すべてのエラーは、トラブルシューティングに役立つ説明的なメッセージを含む構造化形式で返されます。