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 文件。