RSS阅读器API连接服务

通过Model Context Protocol连接AI助手和NewsBlur RSS阅读器API的服务,支持阅读订阅、管理订阅、标记故事等功能。

  • by clearofcant
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 clearofcant/newsblur-mcp

使用说明

newsblur mcp

一个MCP服务器,将AI助手连接到 NewsBlur RSS阅读器API。阅读提要、管理订阅、明星故事等——所有这些都是通过模型上下文协议完成的。

需求

  • Python 3.13+
  • NewsBlur帐户

安装

uv sync

认证

设置以下环境变量组合之一:

选项1:会话cookie (推荐--避免发送凭据)

export NEWSBLUR_SESSIONID="your-session-id"

选项2:用户名/密码

export NEWSBLUR_USERNAME="your-username"
export NEWSBLUR_PASSWORD="your-password"

用法

克劳德代码

添加到您的Claude Code MCP配置中(~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "newsblur": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/newsblur-mcp", "newsblur-mcp"],
      "env": {
        "NEWSBLUR_SESSIONID": "your-session-id"
      }
    }
  }
}

MCP检查员

uv run mcp dev src/newsblur_mcp/server.py

直接

uv run newsblur-mcp

工具

阅读

工具 说明
get_feeds 列出所有已订阅的订阅源和文件夹
get_feed_stories 从单个提要中获取故事
get_river_stories 从多个提要中获取故事(河景)
get_starred_stories 获取星级/保存的故事,可选按标签
get_unread_story_hashes 获取所有未读故事的哈希值
get_original_text 获取故事的原始全文内容
search_stories 按关键字搜索故事

故事动作

工具 说明
mark_stories_read 将一个或多个故事标记为已读
mark_story_unread 将故事标记为未读
star_story 明星/保存故事,可选标签
unstar_story 从故事中删除一颗星
mark_feed_read 将提要中的所有故事标记为已读
mark_all_read 将所有故事标记为已读(可选择超过N天)

饲料管理

工具 说明
add_feed 通过URL订阅新订阅源
delete_feed 取消订阅源
rename_feed 重命名订阅源
move_feed 在文件夹之间移动提要
discover_feeds 按URL或关键字搜索新提要

文件夹管理

工具 说明
add_folder 创建新文件夹
delete_folder 删除文件夹
rename_folder 重命名文件夹
move_folder 将文件夹移动到其他父文件夹

发展

# Install dev dependencies
uv sync --group dev

# Run tests
uv run pytest

# Run a single test
uv run pytest tests/test_client.py::test_auth_login