Inoreader MCP

🚀 Inoreader MCP 集成

這是一個 MCP（模型上下文協議）服務器，它將 Inoreader 與 Claude Desktop 集成在一起，實現智能 RSS 訂閱源管理與分析。

🚀 快速開始

本項目將 Inoreader 與 Claude Desktop 集成，提供了強大的 RSS 訂閱源管理與分析功能。安裝完成並配置好後，你就可以使用自然語言命令來管理和分析訂閱內容。

✨ 主要特性

訂閱源與文章管理

• 列出訂閱源：查看所有已訂閱的 RSS 訂閱源
• 列出文章：通過過濾器（未讀、按訂閱源、按時間段）瀏覽文章
• 閱讀內容：訪問特定文章的完整內容
• 標記為已讀：單獨或批量標記文章為已讀

搜索與分析

• 搜索文章：在所有訂閱源中搜索關鍵詞
• 總結文章：為單篇文章生成摘要
• 分析多篇文章：
  • 綜合摘要
  • 趨勢分析
  • 情感分析
  • 關鍵詞提取
• 統計信息：查看未讀文章計數器

📦 安裝指南

🚀 自動安裝程序（推薦）

一條命令即可完成所有安裝：

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

使用你的 Inoreader 憑證編輯 .env 文件：

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。你可以使用以下自然語言命令進行操作：

列出訂閱源：

• "列出我的訂閱源"
• "我訂閱了哪些訂閱源？"

列出文章：

• "顯示最近 20 篇未讀文章"
• "我從 TechCrunch 訂閱源有哪些未讀文章？"
• "顯示最近 3 天的文章"

搜索：

• "搜索關於人工智能的文章"
• "查找最近 7 天的 Python 文章"

閱讀和標記：

• "閱讀文章 [ID]"
• "將訂閱源 X 的所有文章標記為已讀"

分析：

• "總結本週前 5 篇人工智能文章"
• "分析我今天訂閱源中的趨勢"
• "經濟類文章的整體情感如何？"
• "從未讀文章中提取關鍵詞"

統計信息：

• "我有多少篇未讀文章？"
• "顯示我的訂閱源統計信息"

📚 詳細文檔

項目結構

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 中具有必要的權限

MCP 未在 Claude 中顯示：

• 檢查配置文件中的完整路徑
• 重啟 Claude Desktop
• 確認 Python 已添加到系統路徑

請求超時：

• Inoreader API 可能較慢
• 嘗試減少請求的文章數量

🤝 貢獻

歡迎貢獻代碼！請按照以下步驟進行：

1. 分叉項目
2. 創建一個功能分支
3. 提交你的更改
4. 將更改推送到分支
5. 打開一個拉取請求

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。