feedly-mcp

从 Claude 里读取您的 Feedly 订阅。问一句 “我的 AI 订阅源里最近有什么？” 就能得到回答，无需打开浏览器。

⚠️ 目前这里还没有任何可安装的内容

这个仓库目前只包含设计文档，没有任何代码。

没有 npm 包、没有 .mcpb 捆绑包，也没有任何发布版本。下面的每一条命令今天都会执行失败。它们是先写出来的意图体验说明，以便在实现之前先设计好安装流程。

想知道这个状态何时会变，可 Watch 本仓库。

它能做什么

六种工具，让 agent（智能体）读取您的 Feedly 账号：

它不做什么

这是一个连接器（connector），而不是阅读器应用。它把请求翻译成 Feedly API 调用，并交回一个简洁的答案。它不会存储您的文章、建立可搜索的存档、对内容长期排名，也不会发送摘要。

这些功能当然都有价值——请把它们构建在这个工具之后，放在一个 Claude Project、一个 skill 或一个定时任务里。把这些移出核心，才能让这个工具保持小巧并提供可信。

隐私

一切都在您自己的机器上运行。

• 您的 Feedly 令牌只留在本地。除了 api.feedly.com 之外，不会发送到任何地方。

• 不需要在我们这里注册，没有中间服务器，也没有任何遥测。

• 您读到的内容本身不会被存储起来，只有一个短暂存在的本地缓存。

系统要求

• Node.js 20 或更新 — 用 node --version 查看

• 一个 Feedly 账号和一个 API 令牌（见下方步骤 1）

• Claude Desktop、Claude Code 或任何其他 MCP 客户端

步骤 1 — 获取 Feedly API 令牌

1. 在浏览器中登录 Feedly。

2. 访问 https://feedly.com/v3/auth/dev。

3. 按里面的说明生成一个开发者访问令牌。

4. 把令牌复制到安全的地方，留着下一步用。它就是一个密码——请像对待密码一样对待它。

继续之前，先了解两件事。

令牌会过期。 免费账号的开发者令牌有效期大约 30 天，之后需要重新执行这个步骤。付费方案可以自动刷新。这是 Feedly 的规定，不是这个工具能够绕开的。

能否获取令牌取决于您的套餐。 Feedly 自己的文档对哪些账号等级可以自助发放 API 令牌描述并不一致。如果上面这个页面不能提供令牌，那么这个连接器就无法配合您的账号工作，除了联系 Feedly 外没有解决办法。

步骤 2 — 安装

目前尚未可用。 下面三条路径都依赖一个已经发布出的构建物——一个 npm 包或一个 .mcpb 捆绑包——而这两者目前都不存在。这一节是规划，而不是现在就能照做的指示。

在下面三条路径中 选择一条。

选项 A — Claude Desktop 一键安装（最简单）

1. 从仓库 Releases 页面下载最新的 feedly-mcp.mcpb。（目前还没有发布任何版本。）

2. 打开 Claude Desktop → 设置 → 扩展。

3. 把这个 .mcpb 文件拖进窗口。

4. 会出现一个设置表单。把你的令牌粘贴到 Feedly API 令牌 中，然后点击安装。

您的令牌会进入操作系统的钥匙串，而不是一个纯文本文件。 配置 里的每一项都可以在这里直接编辑。

选项 B — Claude Desktop 手动配置

1. 打开您的 Claude Desktop 配置文件：

   操作系统	路径
   macOS	~/Library/Application Support/Claude/claude_desktop_config.json
   Windows	%APPDATA%\Claude\claude_desktop_config.json

   如果该文件不存在，就以 {} 为内容创建它。

2. 添加一个 feedly 条目：

   {
     "mcpServers": {
       "feedly": {
         "command": "npx",
         "args": ["-y", "feedly-mcp"],
         "env": {
           "FEEDLY_TOKEN": "paste-your-token-here"
         }
       }
     }
   }

   在 mcpServers 下已经有其他服务器了？把 feedly 加到它们旁边——不要替换掉整个块。

3. 完全重启 Claude Desktop。 关闭窗口不够；要退出整个应用。

4. 在消息框上寻找工具图标，feedly 应该会被列出来。

选项 C — Claude Code

claude mcp add feedly --env FEEDLY_TOKEN=paste-your-token-here -- npx -y feedly-mcp

这样验证它是否注册成功：

claude mcp list

如果你的版本使用环境变量时预期不同的标志，运行：

claude mcp add --help

步骤 3 — 检查是否可用

在向 Claude 提问之前，先从终端确认连接：

FEEDLY_TOKEN=paste-your-token-here npx -y feedly-mcp doctor

一次正常的结果大致是这样：

✓ Token found          (environment variable FEEDLY_TOKEN)
✓ Connected to Feedly   you@example.com
✓ 8 folders

  Tech                    70 feeds   user/<uuid>/category/Tech
  Tech - Research         11 feeds   user/<uuid>/category/<uuid>
  Tech - Tooling           6 feeds   user/<uuid>/category/<uuid>
  …

  API calls used today: 1 of 50   (resets in 11h34m)

doctor 永远不会打印出你的令牌。在步骤 4 里填写 scope 时，就可以使用它给你的文件夹列表。

如果有问题，请跳到 Troubleshooting。

步骤 4 — 配置（可选）

默认配置很合理，完全可以跳过这一步。最值得早期了解的设置是 scope（范围）——它决定 Claude 到底能看到哪些文件夹。

创建 ~/.config/feedly-mcp/config.toml：

[scope]
# Only these folders are visible to the agent. Leave empty for all of them.
include_folders = ["AI", "Longform"]

# Used when you ask about articles without naming a folder.
default_folder = "AI"

[defaults]
hours = 8          # how far back get_articles looks
limit = 100        # max articles per call

设置 include_folders 有两个好处：

• 隐私（Privacy）。 你的工作文件夹不需要对一个 agent 可读。

• 专注（Focus）。 更少的文件夹意味着更短的回答，也意味着更少的上下文浪费在你没说要去读的内容上。

如果你是通过选项 A 安装的，可以在扩展的设置表单中直接修改这些选项——选项相同，只不过不用找文件。

完整的设置列表：docs/configuration.md

使用方法

直接提出需求就行。一些不错的问题示例：

• “我的 AI 订阅源从昨天起有哪些新东西？”

• “这周的'AI - Research'里有什么值得读的？”

• “我有多少未读文章，按文件夹列出来？”

• “帮我找一些关于本地 LLM 推理的订阅源。”

• “把过去 8 小时里参与度最高的 top 5 总结一下。”

你不需要知道文件夹 ID。文件夹名字就可以，Claude 也能列出它们。

完整的工具参考：docs/tools.md

你的 API 配额——请务必阅读

你的每日 API 配额很小——比 Feedly 文档里暗示的要小得多。

实际测试 API 平台返回数据，付费 Pro Plus 账号上的开发者在 token 的日限额是 每天 50 次调用，大约在 UTC 时间午夜重置。而 Feedly 自己的文档写的是 250（免费）和 500（Pro）总之按 50 来规划。

如果 agent 很“健谈”，那大约也就是一天 8 次对话；而配额是和所有其他同时使用你账号的请求共享的——包括你在浏览器里的 Feedly。如果一个 agent 把它跑干掉了，web 内的 Feedly 也无法是。

所以这个工具会以你的身份来守护这个预算：

• 文件夹和订阅列表在磁盘上缓存 24 小时。

• 15 分钟之内的重复相同请求直接从缓存返回。

• 一次调用获取整个文件夹的内容，永远不会为一个 feed 调用一次请求。

• 每次 sessions 最多 10 次调用、每天的 40 次调用上限，其余预留给你自己。

• 每次响应都会报告还剩多少配额。低于 10 时会给出你需要知道可能进行了情况。

并用 doctor 查看一下你自己的实际上限——它会输出你的账号真实返回的配额值。如果它给出的数字比 50 高，你可以在 configuration 中安全调高预算。

标记文章为已读

mark_read 是永久性的操作。Feedly 没有撤销概念，恢复也只能联系他们的支持。所以它默认是关闭的。

要开启单篇文章标记：

[writes]
enabled = true

如果你还想允许一键把整个文件夹标成已读（这是一个大得多的爆炸半径），则必须主动再打开另一个开关：

[writes]
enabled = true
bulk_mark_read = true

退订功能完全没有实现，这是有意为之。请你在 Feedly 里做。

Troubleshooting

doctor says the token is missing

服务器查找设置如下顺序：先查找 FEEDLY_TOKEN 环境变量，然后是由 feedly.token_file 指定的文件。确认你的 token 确实重要的是你使用的那种 — 常见错误是：你 In use the config 文件，同时 Claude Desktop 传了一个空的环境变量，它优先将配置覆盖成空。

“Token expired”或者 401

免费账号的 token 大约可运行 30 天。请重新执行 步骤 1 并更新你存放的 token。这是预期情况，并且它会定期出现，不是 bug。

Claude 没有看到工具

完全退出并重新启动 Claude Desktop——仅关闭窗口并不能重启 MCP 服务。然后检查你的 JSON 是否合法（最常见是最后一个逗号），并确认 node --version 输出 20 或更高。

“Rate limit exceeded”（429）

你已经把今天 Feedly 配额都用完了。它在服务端按自己的时间表重置；错误消息里包含重置时间。服务器不会自动重试——重试只会让情况更糟。

“Daily budget exhausted”

这和上面不同：这是这个工具自己的上限，而不是 Feedly 的，而且你的真实配额其实还有。如果你需要更大，在 budget.daily_calls 调高它即可。

“outside configured scope” 的文件夹

你已经设置了 `scope.include_folders，而那个文件夹不在列表里。把它补进去，或清空列表表示允许所有文件夹。

缓存中的数据看起来属于另一个账号

清掉缓存再试一次：

rm -rf ~/.cache/feedly-mcp

参与贡献

欢迎 Issues 和 Pull Requests。设计理由——包括被刻意排除的功能——在 feedlymcpspec.md 中。在你提出新功能之前，请先读一读。如果你的想法已经属于 “outside scope”里面的那个清单，那是一个有意决策，而不是遗犯，但你完全可以来反驳它。

许可证

MIT