AI导哈

Substack文章阅读服务

一个本地运行的Substack文章阅读服务器，支持从Cursor、Claude Desktop等MCP客户端读取文章、评论和订阅内容。

  • by jenny-ouyang
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 jenny-ouyang/substack-article-mcp

使用说明

子堆栈文章mcp

用于Substack的MCP服务器——从Cursor、Claude Desktop、Claude Code或任何MCP客户端读取文章、评论、提要和订阅。公共内容在没有身份验证的情况下工作；登录以获取高级/付费文章和个性化功能。

快速开始

选择您的AI客户端：

光标

一个命令--登录并自动配置Cursor：

npx -y substack-article-mcp install --cursor

安装后重新启动Cursor。

克劳德代码

一个命令--登录并全局添加MCP：

npx -y substack-article-mcp install --claude-code

克劳德桌面版

下载 .mcpb 延伸自 发布页面 然后双击进行安装。

可选： 安装后，转到“扩展”>“Substack文章”>“设置”，粘贴Substack cookie以解锁付费文章、订阅和提要。将其留空，仅供公众访问。

用它

通过聊天提问——应用程序会自动启动服务器：

  • “列出platformer的最新文章” （公开，无需身份验证）
  • “获取文章184929446的全部内容” （适用于数字ID）
  • “显示对此文章的评论”
  • “在平台文章中搜索‘反垄断’”
  • “我订阅哪些时事通讯？” （需要身份验证）
  • “显示我的阅读器订阅源” （需要身份验证）

认证

身份验证是可选的。 公共工具(list_articles, get_article, search_articles, get_comments)只要指定一个子域名，就可以在没有任何凭据的情况下工作。

登录解锁：

  • 全额付费/高级文章内容
  • list_subscriptions --查看您关注的所有新闻通讯
  • get_feed --您的个性化阅读器订阅源
  • get_inbox --所有订阅的按时间顺序排列的收件箱
  • 自动检测默认子域（因此您不需要指定一个）

auth的工作原理

服务器按以下优先级顺序检查凭据：

  1. SUBSTACK_COOKIE 环境变量 --由Claude Desktop使用 .mcpb 扩展（从设置中的可选cookie字段自动设置）
  2. ~/.substack-article-mcp/auth.json --被拯救了 login 或 install 命令
  3. 无身份验证 --仅限公共内容

刷新凭据

Substack Cookie每隔几周过期一次。当工具开始返回身份验证错误时：

  • 光标/克劳德代码： 跑 npx -y substack-article-mcp login 在您的终端
  • 克劳德桌面： 转到扩展>子包文章>设置并粘贴一个新的cookie

手动获取cookie

  1. 在Chrome浏览器中打开substack.com并登录
  2. DevTools（F12）→ 应用→ Cookie→ substack.com
  3. 复制以下值 substack.sid （以及 substack.lli 付费文章）
  4. 用作： substack.sid=YOUR_VALUE; substack.lli=YOUR_LLI_VALUE

命令行命令

命令 描述
npx -y substack-article-mcp install --cursor 登录+将MCP添加到游标
npx -y substack-article-mcp install --claude-code 登录+将MCP添加到Claude Code
npx -y substack-article-mcp login 刷新凭据（Chrome登录流程）
npx -y substack-article-mcp login --manual '<cookie>' 直接粘贴Cookie
npx -y substack-article-mcp login --check 检查身份验证状态和cookie年龄
npx -y substack-article-mcp --help 显示帮助
npx -y substack-article-mcp --version 显示版本

不要 跑 npx -y substack-article-mcp 终端中没有任何争论。这将启动MCP stdio服务器，您的终端将出现卡滞。你的AI客户端会自动启动它。

MCP工具

工具 需要授权 说明
substack_auth_status 否 检查身份验证状态、cookie年龄并获取刷新指导
list_articles 否* 列出已发布的文章及其元数据和参与度统计数据
get_article 否* 全文为降价。接受slug或数字帖子ID
search_articles 否* 按关键字搜索文章
get_comments 否* 包含回复和反应的完整评论树
list_subscriptions 是 您订阅的所有时事通讯（付费、付费、免费）
get_feed 是 来自订阅新闻通讯的个性化读者订阅
get_inbox 是 按时间顺序分页的收件箱

*需要a subdomain 如果未通过身份验证，则返回参数。付费/高级内容需要授权。

所有内容工具都接受可选 subdomain 用于阅读任何时事通讯的参数（例如。， subdomain: "platformer").

get_article 和 get_comments 还接受数字帖子ID（例如。， 184929446).使用ID时，会自动检测发布。

隐私和安全

  • 服务器正在运行 完全在您的本地计算机上 作为AI客户端的子流程
  • 没有云托管，没有中间服务器
  • 您的凭据永远不会离开您的计算机
  • 这 login 命令在中使用专用的Chrome配置文件 ~/.substack-article-mcp/chrome-profile/ --与常规Chrome完全分离

需求

  • Node.js 18+
  • 谷歌浏览器 （为 login / install 仅限命令，Claude Desktop不需要）

免责声明

使用Substack的内部API。用于个人/实验目的。不隶属于Substack。

许可证

麻省理工学院

相关 MCP