Inoreader MCP

🚀 Inoreader MCP統合

InoreaderをClaude Desktopと統合するMCP（Model Context Protocol）サーバーです。これにより、RSSフィードのインテリジェントな管理と分析が可能になります。

✨ 主な機能

フィードと記事の管理

• フィードの一覧表示：登録しているすべてのフィードを表示します。
• 記事の一覧表示：フィルター（未読、フィード別、期間別）を使用して記事を閲覧します。
• 記事内容の閲覧：特定の記事の全文を閲覧します。
• 既読マーク：記事を個別または一括で既読にマークします。

検索と分析

• 記事の検索：フィード全体でキーワードを検索します。
• 記事の要約：個々の記事の要約を生成します。
• 複数記事の分析：
  • 統合要約
  • トレンド分析
  • 感情分析
  • キーワード抽出
• 統計情報：未読記事のカウンターを表示します。

📦 インストール

🚀 自動インストーラー（推奨）

1つのコマンドですべてをインストールします：

python3 install_inoreader_mcp.py

自動インストーラーは以下のことを行います：

• ✅ すべてのPython依存関係をインストールします。
• ✅ Inoreaderの認証情報の入力を求めます。
• ✅ Claude Desktopを自動的に設定します。
• ✅ すべてを使用可能な状態にします！

Windowsユーザー： install.batをダブルクリックしてください。

📦 ドラッグ&ドロップインストール

inoreader-mcp.dxtをClaude Desktopにドラッグ&ドロップしてみてください（実験的 - すべてのバージョンで動作するとは限りません）

🛠️ 手動インストール

1. リポジトリをクローンします

git clone <repository-url>
cd inoreader_mcp

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

pip install -r requirements.txt

3. 認証情報を設定します

.env.exampleファイルを.envにコピーします：

cp .env.example .env

.envファイルを編集して、Inoreaderの認証情報を入力します：

INOREADER_APP_ID=your_app_id
INOREADER_APP_KEY=your_app_key
INOREADER_USERNAME=your_email
INOREADER_PASSWORD=your_password

認証情報を取得するには：

1. https://www.inoreader.com/developers/ にアクセスします。
2. 新しいアプリケーションを作成します。
3. アプリIDとアプリキーをコピーします。

4. Claude Desktopで設定します

Claude Desktopの設定ファイル（macOSの場合は~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "inoreader": {
      "command": "python",
      "args": ["/full/path/to/inoreader_mcp/main.py"],
      "env": {
        "INOREADER_APP_ID": "your_app_id",
        "INOREADER_APP_KEY": "your_app_key",
        "INOREADER_USERNAME": "your_email",
        "INOREADER_PASSWORD": "your_password"
      }
    }
  }
}

💻 使用例

設定後、Claude Desktopを再起動します。コマンドは自然言語で利用できます：

基本的な使用法

# 以下はコマンドの例です
# フィードの一覧表示
- "List my feeds"
- "What feeds do I follow?"

# 記事の一覧表示
- "Show the last 20 unread articles"
- "What unread articles do I have from TechCrunch?"
- "Show articles from the last 3 days"

# 検索
- "Search articles about artificial intelligence"
- "Find Python articles from the last 7 days"

# 閲覧と既読マーク
- "Read article [ID]"
- "Mark all articles from feed X as read"

# 分析
- "Summarize the top 5 AI articles this week"
- "Analyze trends in my feeds today"
- "What's the overall sentiment of economy articles?"
- "Extract keywords from unread articles"

# 統計情報
- "How many unread articles do I have?"
- "Show my feed statistics"

📚 ドキュメント

プロジェクト構造

inoreader_mcp/
├── main.py              # メインのMCPサーバー
├── inoreader_client.py  # Inoreader APIクライアント
├── tools.py             # MCPツールの実装
├── config.py            # 設定と認証情報
├── utils.py             # ヘルパー関数
├── requirements.txt     # Python依存関係
├── .env.example         # 設定例
└── README.md           # このファイル

開発

ローカルでのテスト

python main.py

ログ

ログはコンソールに出力されます。デバッグする場合は、Claude Desktopのコンソールを確認してください。

制限事項

• リクエストごとの最大記事数は50件です。
• フィードリストのキャッシュ時間は5分です。
• APIリクエストのタイムアウト時間は10秒です。

トラブルシューティング

認証エラー：

• 認証情報が正しいことを確認してください。
• Inoreaderでアプリに必要な権限が付与されていることを確認してください。

ClaudeにMCPが表示されない：

• 設定ファイルのパスが正しいことを確認してください。
• Claude Desktopを再起動してください。
• PythonがシステムのPATHに含まれていることを確認してください。

リクエストがタイムアウトする：

• Inoreader APIが遅い可能性があります。
• 要求する記事の数を減らしてみてください。

コントリビューション

コントリビューションは歓迎されます！以下の手順で行ってください：

1. プロジェクトをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを開きます。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。