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