子堆栈文章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的工作原理
服务器按以下优先级顺序检查凭据：
SUBSTACK_COOKIE环境变量 --由Claude Desktop使用.mcpb扩展（从设置中的可选cookie字段自动设置）~/.substack-article-mcp/auth.json--被拯救了login或install命令- 无身份验证 --仅限公共内容
刷新凭据
Substack Cookie每隔几周过期一次。当工具开始返回身份验证错误时：
- 光标/克劳德代码： 跑
npx -y substack-article-mcp login在您的终端 - 克劳德桌面： 转到扩展>子包文章>设置并粘贴一个新的cookie
手动获取cookie
- 在Chrome浏览器中打开substack.com并登录
- DevTools（F12）→ 应用→ Cookie→ substack.com
- 复制以下值
substack.sid（以及substack.lli付费文章） - 用作：
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 |
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。
许可证
麻省理工学院