Rss MCP

🚀 RSS MCP Server

このサーバーは、TypeScriptで構築されたModel Context Protocol (MCP) サーバーです。任意の標準的なRSS/Atomフィードを取得して解析する汎用ツールを提供し、RSSHub フィードにも特別なサポートを備えています。このサーバーを使用することで、言語モデルやその他のMCPクライアントは、様々なWebソースから構造化されたコンテンツを簡単に取得することができます。

サーバーには、公開されているRSSHubインスタンスのリストが組み込まれており、ポーリングメカニズムをサポートして利用可能なインスタンスを自動的に選択するため、データ取得の成功率と安定性が大幅に向上します。

✨ 主な機能

• 汎用フィード解析: 与えられたURLから任意の標準的なRSS/Atomフィードを取得して解析します。
• 拡張されたRSSHubサポート: get_feed というツールを提供し、MCPを介してRSSHubがサポートする任意のフィードを取得し、マルチインスタンスをサポートします。
• マルチインスタンスサポート: 公開されているRSSHubインスタンスのリストを含み、利用可能なサービスを自動的にポーリングして検索します。
• スマートURL解析: 標準的なRSSHub URLと簡略化された rsshub:// プロトコル形式をサポートします。
• 優先インスタンス設定: PRIORITY_RSSHUB_INSTANCE 環境変数を使用して、優先するRSSHubインスタンスを設定できます。
• 強力なエラーハンドリング: あるインスタンスへのリクエストが失敗した場合、自動的に次のインスタンスを試し、成功するかすべてのインスタンスが失敗するまで続けます。
• コンテンツクリーニング: Cheerioを使用してフィードコンテンツをクリーニングし、プレーンテキストの説明を抽出します。
• 標準化された出力: 取得したRSSフィードを構造化されたJSON形式に変換します。

📦 インストール

まず、プロジェクトリポジトリをクローンし、必要な依存関係をインストールします。

git clone <your-repo-url>
cd rss-mcp
npm install

🚀 クイックスタート

1. プロジェクトのビルド

実行する前に、TypeScriptコードをJavaScriptにコンパイルする必要があります。

npm run build

2. サーバーの起動

ビルドが成功したら、MCPサーバーを起動します。

npm start

サーバーは、Stdioを介して親プロセス（例: Cursor）と通信します。

3. 優先インスタンスの設定（オプション）

.env ファイルを作成して、優先するRSSHubインスタンスを指定することができます。これは、プライベートで安定したインスタンスを持っているユーザーに非常に便利です。

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

PRIORITY_RSSHUB_INSTANCE=https://my-rsshub.example.com

サーバーは起動時にこの設定を自動的に読み込み、ポーリングリストの先頭に配置します。

🔧 MCPサーバーの設定

CursorなどのMCPクライアントでこのサーバーを使用するには、設定ファイルに追加する必要があります。

方法1: npx を使用する（推奨）

パッケージがnpmに公開されている場合、npx を使用してローカルにインストールせずにサーバーを実行できます。これが最も簡単な方法です。

1. MCP設定ファイルを見つけます。（例: ~/.cursor/mcp_settings.json）
2. 以下のサーバーエントリを追加します。

{
  "name": "rss",
  "command": ["npx", "rss-mcp"],
  "type": "stdio"
}

方法2: ローカルインストール

リポジトリをローカルにクローンした場合は、node で直接実行することができます。

1. プロジェクトをクローンしてビルドします。「インストール」と「使用方法」のセクションで説明されている通りに行います。
2. MCP設定ファイルを見つけます。
3. 以下のサーバーエントリを追加し、コンパイルされた index.js ファイルの絶対パスを使用するようにしてください。

{
  "name": "rss",
  "command": ["node", "/path/to/your/rss-mcp/dist/index.js"],
  "type": "stdio"
}

重要: /path/to/your/rss-mcp/dist/index.js をシステム上の正しい絶対パスに置き換えてください。

設定を追加した後、MCPクライアント（例: Cursor）を再起動して変更を有効にします。その後、rss サーバーが利用可能になり、get_feed ツールを呼び出すことができます。

💻 使用例

基本的な使用法

get_feed ツールを使用して、RSSフィードを取得する基本的なコード例です。

# ここには実際の呼び出しコードが入りますが、元のREADMEにはなかったため省略。
# コード例があれば、ここに保持されます。

高度な使用法

優先インスタンスを設定して、特定のRSSHubインスタンスを使用する場合のコード例です。

# ここに高度なシナリオのコード例が入りますが、元のREADMEにはなかったため省略。
# コード例があれば、ここに保持されます。

🛠️ ツール定義

get_feed

与えられたURLからRSSフィードを取得して解析します。標準的なRSS/AtomフィードとRSSHubフィードの両方をサポートします。

入力パラメータ

• url（文字列、必須）: 取得するRSSフィードのURL。2つの形式がサポートされています。
  1. 標準URL: https://rsshub.app/bilibili/user/dynamic/208259
  2. rsshub:// プロトコル: rsshub://bilibili/user/dynamic/208259（サーバーは自動的に利用可能なインスタンスを選択します）

出力

フィード情報を含むJSON文字列が返され、以下の構造を持ちます。

{
  "title": "bilibili User Dynamics",
  "link": "https://space.bilibili.com/208259",
  "description": "bilibili User Dynamics",
  "items": [
    {
      "title": "[Dynamic Title]",
      "description": "Plain text content of the dynamic...",
      "link": "https://t.bilibili.com/1234567890",
      "guid": "https://t.bilibili.com/1234567890",
      "pubDate": "2024-05-20T12:30:00.000Z",
      "author": "Author Name",
      "category": ["Category1", "Category2"]
    }
  ]
}

📜 主な依存関係

📄 ライセンス

このプロジェクトは、Apache-2.0ライセンスの下でライセンスされています。