Inoreader MCP服务器
一种MCP（模型上下文协议）服务器，它通过Inoleeader API提供RSS提要管理功能。这使得像Claude这样的LLM能够代表您阅读和管理RSS提要。
建于 包子 用于快速启动和低内存使用。
特性
- OAuth2身份验证 -基于浏览器的登录，带有安全的密钥链存储
- 自动令牌刷新 -令牌过期时会自动刷新
- 阅读文章 -从您的订阅源中获取未读、带星号或所有文章
- 管理订阅 -添加或删除RSS订阅源
- 组织内容 -将文章标记为已读/未读、标记文章、添加标签
- 浏览订阅源 -列出订阅、文件夹、标签和未读计数
需求
- 包子 1.0+
- Inreader Pro帐户（API访问需要Pro订阅）
- Inreader API凭证（应用程序ID和应用程序密钥）
- macOS：钥匙扣（内置）
- Linux：libsecret(
apt install libsecret-tools)
安装
快速入门（通过bunx）
无需安装-直接从GitHub运行：
bunx github:seiji/inoreader-mcp-server # latest
bunx github:seiji/inoreader-mcp-server#v0.1.0 # specific version本地开发
git clone https://github.com/seiji/inoreader-mcp-server.git
cd inoreader-mcp-server
bun install认证
1.获取API凭据
- 首选 Inoreader开发者门户
- 使用以下设置注册新应用程序：
- 重定向URI: http://localhost:19812/callback - 范围: read 和 write
- 记下你的 应用程序ID 和 应用程序密钥
2.设置环境变量
export INOREADER_APP_ID="your-app-id"
export INOREADER_APP_KEY="your-app-key"3.登录
# This opens your browser for OAuth authentication
bun run src/index.ts auth login令牌安全地存储在您的系统密钥链中：
- macOS：钥匙链访问
- Linux：GNOME钥匙圈/KDE钱包（通过libsecret）
身份验证命令
# Login - opens browser for OAuth authentication
bunx github:seiji/inoreader-mcp-server auth login
# Check authentication status
bunx github:seiji/inoreader-mcp-server auth status
# Logout - remove tokens from keychain
bunx github:seiji/inoreader-mcp-server auth logout用法
运行服务器
# Via bunx (recommended)
bunx github:seiji/inoreader-mcp-server
# Local development
bun run startClaude桌面配置
添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"inoreader": {
"command": "bunx",
"args": ["github:seiji/inoreader-mcp-server"],
"env": {
"INOREADER_APP_ID": "your-app-id",
"INOREADER_APP_KEY": "your-app-key"
}
}
}
}备注：在运行auth命令之前，请确保 INOREADER_APP_ID 和 INOREADER_APP_KEY 在shell环境中设置（请参见 2.设置环境变量 上文）。配置后，运行 bunx github:seiji/inoreader-mcp-server auth login 一次验证。令牌存储在密钥链中并自动刷新。
可用工具
| 工具 | 说明 |
|---|---|
get_user_info | 获取经过身份验证的用户信息 |
get_unread_counts | 获取所有订阅源的未读计数 |
get_subscriptions | 列出所有RSS订阅 |
get_folders_and_tags | 列出文件夹和标签 |
get_articles | 从订阅源获取文章（带过滤器） |
get_starred_articles | 获得星级/保存的文章 |
add_subscription | 订阅新的RSS源 |
remove_subscription | 取消订阅源 |
mark_as_read | 将文章标记为已读 |
mark_as_unread | 将文章标记为未读 |
star_article | 星/保存文章 |
unstar_article | 从文章中删除星号 |
add_tag_to_article | 为文章添加自定义标签 |
remove_tag_from_article | 从文章中删除标签 |
交互示例
一旦配置了Claude，您可以：
- “显示我的未读文章”
- “我的RSS订阅是什么？”
- “订阅https://example.com/feed.xml"
- “将我的技术文件夹中的所有文章标记为已读”
- “明星第一篇关于AI的文章”
- “我有多少未读文章？”
发展
# Install dependencies
bun install
# Run in development mode (with watch)
bun run dev
# Type check
bun run typecheck
# Lint
bun run lint
# Format
bun run format故障排除
“钥匙扣不可用”
Linux：安装libsecret工具：
sudo apt install libsecret-tools“令牌过期”错误
跑 bunx github:seiji/inoreader-mcp-server auth login 重新验证。
免责声明
该项目是一个非官方的社区开发工具，不隶属于Inoreader，也不受其认可或赞助。“Inreader”是Innologica有限公司的商标。
要使用此MCP服务器，您必须：
- 有你自己的 Inoreader Pro 订阅（API访问需要Pro）
- 在以下网址注册您自己的申请 Inoreader开发者门户
- 遵守Inoreader的 服务条款
此项目不包括任何API密钥或令牌。每个用户都必须获得自己的凭据。
许可证
麻省理工学院