使用说明
RSS阅读器MCP
一个用于RSS订阅聚合和文章内容提取的MCP(模型上下文协议)服务器。您可以使用它来订阅RSS订阅源并获取文章列表,或者从URL中提取文章的完整内容,并将其格式化为Markdown。
英语 | 中文
🚀 快速入门
您可以在支持MCP的客户端中使用此MCP服务器,例如 Claude Desktop(可译为“Claude桌面版”或保持原样,根据语境决定是否需要意译) 并且 CherryStudio(樱桃工作室).
Claude Desktop(可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”)
对于 Claude Desktop,请在您的配置文件中“mcpServers”部分下添加以下配置 claude_desktop_config.json 文件:
{
"mcpServers": {
"rss-reader": {
"command": "npx",
"args": [
"-y",
"rss-reader-mcp"
]
}
}
}
使用示例
-
基本RSS订阅源获取
你能从BBC新闻的RSS订阅源中获取最新的5条头条新闻吗? 网址: https://feeds.bbci.co.uk/news/rss.xml
-
全文内容提取
请提取这篇文章的全部内容,并将其格式化为Markdown格式: https://example.com/news/article-title
🔧 工具参考
fetch_feed_entries
从指定的URL获取RSS条目
参数:
url(必填字符串):RSS订阅源URLlimit(可选数字):要返回的条目最大数量(默认10,最大100)
返回值: 一个包含订阅元数据和条目列表(包括标题、链接、发布日期和摘要)的JSON对象
fetch_article_content
从URL中提取文章内容并将其格式化为Markdown
参数:
url(必填字符串):文章URL
返回值: 一个包含标题、Markdown 内容、来源 URL 和时间戳的 JSON 对象
⚙️ 传输与环境变量
此服务器支持两种传输模式:
- stdio(默认):通过标准输入/输出进行通信。适用于运行本地进程的客户端,例如Claude桌面版。
- httpStream:通过HTTP流进行通信。适用于支持HTTP(S)传输的客户端或容器化部署。
可用的环境变量:
- 传输:选择传输模式,可选
stdio(默认)或httpStream. - 端口:当
TRANSPORT=httpStream,监听端口(默认8081)。 - MCP_SERVER_HOST:当
TRANSPORT=httpStream,监听地址(默认localhost)。 在Docker中,将此设置为0.0.0.0将端口暴露给外部。
如何切换交通方式:
- 使用 stdio(无需额外设置,默认配置):
- 通过与Claude Desktop配合使用
command + args配置(见上例)。
- 通过与Claude Desktop配合使用
- 使用httpStream:
- 设置环境变量
TRANSPORT=httpStream并明确说明PORT(如果未设置,则默认为8081)。 - 当在容器中运行时,也需设置
MCP_SERVER_HOST=0.0.0.0并映射端口。 - 此仓库中的 Dockerfile 已经包含了相关的环境变量设置。
- 设置环境变量
Docker 部署
你也可以在Docker容器中运行这个MCP服务器。首先,在项目根目录下构建镜像:
docker build -t rss-reader-mcp .
以CherryStudio为例,以下配置展示了如何通过HTTP运行此服务器:
{
"mcpServers": {
"rss-reader-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-p",
"8081:8081",
"-e",
"PORT=8081",
"rss-reader-mcp"
]
}
}
}
一些用于测试的RSS订阅源
- BBC新闻:
https://feeds.bbci.co.uk/news/rss.xml - TechCrunch:(科技媒体或博客名称,直译为“科技评论”)
https://techcrunch.com/feed/ - 黑客新闻(Hacker News):
https://hnrss.org/frontpage - 《麻省理工科技评论》
https://www.technologyreview.com/feed/