Feedly MCP服务器
MCP(模型上下文协议)服务器,使Claude能够与Feedly交互以阅读提要、获取文章摘要并将项目标记为已读。
特性
- 列出订阅 -浏览您的所有订阅源
- 获取未读计数 -检查哪些订阅源有未读文章
- 获取文章 -从订阅源、类别或标签中检索文章
- 获取文章详细信息 -获取完整内容以进行摘要
- 标记为已读 -将文章、提要或类别标记为已读
- 保持未读状态 -撤消将文章标记为已读
安装
先决条件
- Python 3.10或更高版本
- 具有API访问权限的Feedly帐户
使用uv进行安装
uv tool install git+https://github.com/c0ffee0wl/feedly-mcp-server.git从源代码安装
git clone https://github.com/c0ffee0wl/feedly-mcp-server.git
cd feedly-mcp-server
uv tool install -e .配置
Claude代码集成
添加到您的Claude Code MCP配置中(~/.config/claude/mcp.json):
{
"mcpServers": {
"feedly": {
"command": "feedly-mcp",
"env": {
"FEEDLY_ACCESS_TOKEN": "your_token_here"
}
}
}
}可用工具
只读工具
| 工具 | 说明 |
|---|---|
feedly_get_profile | 获取用户资料和ID |
feedly_get_subscriptions | 列出所有订阅源 |
feedly_get_categories | 列出类别/文件夹 |
feedly_get_tags | 列表标签 |
feedly_get_unread_counts | 每个流的未读计数 |
feedly_get_stream_contents | 从流中获取文章 |
feedly_get_entry | 获取单篇文章详细信息 |
feedly_get_entries | 获取多篇文章(批量) |
写入工具
| 工具 | 说明 |
|---|---|
feedly_mark_as_read | 将条目标记为已读 |
feedly_mark_feed_as_read | 将整个提要标记为已读 |
feedly_mark_category_as_read | 将类别标记为已读 |
feedly_keep_unread | 撤消标记为已读 |
用法示例
典型工作流程
- 获取您的用户ID (类别/标签流ID需要):
Use feedly_get_profile to get your user ID- 检查未读计数:
Use feedly_get_unread_counts to see which feeds have unread articles- 从提要中获取文章:
Use feedly_get_stream_contents with stream_id="feed/https://example.com/rss"- 获取完整的文章内容以进行摘要:
Use feedly_get_entry with entry_id="..." to get full content- 将已处理的文章标记为已读:
Use feedly_mark_as_read with entry_ids=["id1", "id2"]流ID格式
- 喂养:
feed/https://example.com/rss - 类别:
user/{userId}/category/{label} - 标签:
user/{userId}/tag/{label} - 所有文章:
user/{userId}/category/global.all - 保存的文章:
user/{userId}/tag/global.saved
响应格式
所有工具都支持两种响应格式:
- 标记语言 (默认):人类可读的格式化输出
- JSON:机器可读JSON输出
通过设置 response_format 参数。
发展
# Install in development mode
git clone https://github.com/c0ffee0wl/feedly-mcp-server.git
cd feedly-mcp-server
uv tool install -e .
# Syntax check
uv run python -m py_compile src/feedly_mcp/server.py
# Run the server directly
feedly-mcp
# Test with MCP Inspector
npx @modelcontextprotocol/inspector错误处理
服务器返回可操作的错误消息:
| 错误 | 消息 |
|---|---|
| 401 | “身份验证失败。请检查FEEDLY_ACCESS_TOKEN。” |
| 403 | “禁止访问。请检查您的Feedly计划。” |
| 404 | “找不到资源。请检查ID。” |
| 429 | “已超出速率限制。请稍候,然后重试。” |
| 超时 | “请求超时。请重试。” |
许可证
GPL-3.0许可证
