使用说明
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