Feedly MCP 服务器

Feedly MCP 服务器是一个协议服务器,使 Claude 能够与 Feedly 交互,用于读取订阅源、获取文章摘要和标记已读项目。

  • by c0ffee0wl
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 c0ffee0wl/feedly-mcp-server

使用说明

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 撤消标记为已读

用法示例

典型工作流程

  1. 获取您的用户ID (类别/标签流ID需要):

    Use feedly_get_profile to get your user ID
    
  2. 检查未读计数:

    Use feedly_get_unread_counts to see which feeds have unread articles
    
  3. 从提要中获取文章:

    Use feedly_get_stream_contents with stream_id="feed/https://example.com/rss"
    
  4. 获取完整的文章内容以进行摘要:

    Use feedly_get_entry with entry_id="..." to get full content
    
  5. 将已处理的文章标记为已读:

    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许可证