Inoreader Mcp

搜索 Python

🚀 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 上（实验性 - 可能并非在所有版本上都有效）

🛠️ 手动安装

克隆仓库

git clone 
cd inoreader_mcp

安装依赖项

pip install -r requirements.txt

配置凭证

将 .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

要获取凭证：

访问 https://www.inoreader.com/developers/
创建一个新应用程序
复制应用程序 ID 和应用程序密钥
在 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 可能较慢
尝试减少请求的文章数量

🤝 贡献

欢迎贡献代码！请按照以下步骤进行：

分叉项目
创建一个功能分支
提交你的更改
将更改推送到分支
打开一个拉取请求

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

0 条评论
分类：搜索