Substack MCP Plus

子组MCP Plus

用于Substack的MCP服务器，允许AI客户端处理您的出版物并研究公共Substack内容。

它支持：

• 用于草稿、发布、日程安排、预览、部分和帖子分析的经过身份验证的帐户工具
• 用于查找、分析和研究Substack帖子和出版物的公共研究工具
• 用于创意、挂钩、重新定位、差距分析和系列规划的内容策略工具

本项目为非官方项目，不隶属于Substack股份有限公司。

你能做什么

使用您自己的Substack帐户：

• 创建格式化草稿
• 更新草稿
• 立即发布
• 安排未来的职位
• 列出草稿、已发布帖子和计划帖子
• 预览草稿
• 上传图片
• 检查路段
• 阅读帖子内容
• 获取帖子分析

对于公共子组内容：

• 跨Substack研究一个主题
• 分析公共帖子URL
• 分析发布URL
• 围绕某一主题制定学习计划
• 从公共帖子中提取编码经验

战略方面：

• 分析你自己的帖子
• 产生帖子创意
• 将帖子重新调整为其他格式
• 运行内容差距分析
• 改进标题和钩子
• 策划一系列

需求

• Node.js >= 16
• Python >= 3.10
• 子堆栈发布URL，例如 https://yourpublication.substack.com

安装

使用npm全局安装：

npm install -g @abanoub-ashraf/substack-mcp-plus

这将安装两个命令：

substack-mcp-plus
substack-mcp-plus-setup

从旧包迁移

如果您之前安装了未作用域 substack-mcp-plus 包装，将其删除 在安装作用域包之前：

npm uninstall -g substack-mcp-plus @abanoub-ashraf/substack-mcp-plus
npm install -g @abanoub-ashraf/substack-mcp-plus@latest
substack-mcp-plus-setup

重新安装后，完全重新启动MCP客户端，使其重新加载命令。

首次设置

运行安装向导：

substack-mcp-plus-setup

设置流程将：

• 打开浏览器
• 让您登录到Substack
• 处理验证码/手动登录流程
• 在本地存储加密的浏览器会话以供以后使用

本地身份验证文件位于 ~/.substack-mcp-plus/auth.json。设置存储 登录后的浏览器会话cookie jar，而不是您的Substack密码。

如果Substack发送了一个电子邮件登录链接，请打开或粘贴该链接 浏览器窗口由打开 substack-mcp-plus-setup。同样的浏览器步骤是 是什么让安装程序捕获最终的身份验证会话。

如果您的客户端后来表示身份验证失败，请再次运行安装程序。

MCP客户端配置

在任何支持stdio服务器定义的MCP客户端中使用此服务器。

服务器块：

{
  "mcpServers": {
    "substack-mcp-plus": {
      "command": "substack-mcp-plus",
      "env": {
        "SUBSTACK_PUBLICATION_URL": "https://YOUR_PUBLICATION.substack.com"
      }
    }
  }
}

如果您的GUI客户端没有继承您的shell PATH，请改用绝对路径：

which substack-mcp-plus

然后更换 "substack-mcp-plus" 带有二进制文件的完整路径。

客户备注

• 克劳德桌面版

配置文件位置：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\\Claude\\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

• 克劳德代码

添加相同内容 mcpServers.substack-mcp-plus 阻止到 ~/.claude.json.

• 法典

将此添加到 ~/.codex/config.toml:

  [mcp_servers.substack-mcp-plus]
  command = "substack-mcp-plus"

  [mcp_servers.substack-mcp-plus.env]
  SUBSTACK_PUBLICATION_URL = "https://YOUR_PUBLICATION.substack.com"

• 光标

在Cursor需要MCP服务器JSON的任何地方添加相同的服务器块。

• 反重力

在Antigravity需要MCP服务器JSON的任何地方添加相同的服务器块。

• 帆板运动

在Windsurf需要MCP服务器JSON的任何地方添加相同的服务器块。

• 通用MCP客户端

如果客户端支持，请使用相同的stdio定义 command + env.

更新配置后，完全重新启动客户端。

刀具清单

发布和帐户工具

• create_formatted_post
• update_post
• publish_post
• schedule_post
• list_drafts
• list_published
• list_scheduled_posts
• get_post_content
• get_post_analytics
• duplicate_post
• preview_draft
• upload_image
• delete_draft
• get_sections
• get_subscriber_count

公共研究工具

• research_substack
• research_substack_post
• research_substack_publication
• study_topic_on_substack
• extract_coding_lessons

战略工具

• analyze_my_posts
• generate_post_ideas
• repurpose_post
• content_gap_analysis
• title_and_hook_optimizer
• series_planner

示例提示

帐户工作流

• List my latest drafts
• Show me my scheduled posts
• Get the content of draft 123456
• Create a draft titled "Why SwiftUI image caching matters" with markdown content
• Schedule draft 123456 for 2026-03-12T09:00:00Z
• Show analytics for published post 123456

研究工作流程

• Research Substack for swiftui image caching
• Research this Substack post: https://www.oneusefulthing.org/p/change-blindness
• Research this publication: https://oneusefulthing.substack.com
• Study SwiftUI performance on Substack
• Extract coding lessons from https://example.substack.com/p/some-post

战略工作流程

• Analyze my posts
• Generate post ideas for indie iOS app marketing
• Repurpose my latest draft into a Twitter thread
• Improve the title and hook for post 123456
• Plan a 5-part series on Swift concurrency

关于确认的注意事项

一些书写动作是有意以确认为导向的。对于创建、更新、发布、计划、复制和删除等影响较大的操作，客户端应在发送最终操作之前进行确认。

已知限制

这些是目前诚实的限制，而不是营销壁纸：

• get_subscriber_count 如果Substack没有通过发布元数据、页面标记或节数据公开可靠的计数，则可能会返回不可用状态。
• 公共研究最适合针对特定问题，例如 swiftui image caching 或 ios concurrency 而不是非常广泛的话题。
• 广泛主题发现的召回率仍然低于利基查询。
• study_topic_on_substack 和 extract_coding_lessons(query=...) 这取决于基础发现结果的质量。
• 公共研究工具仅在可访问和可解析的公共页面上工作。

故障排除

未找到命令

您的客户端可能无法继承您的shell PATH.

查找已安装的二进制文件：

which substack-mcp-plus

然后使用客户端配置中的绝对路径。

认证失败

再次运行安装程序：

substack-mcp-plus-setup

如果Substack发送了登录电子邮件，请将电子邮件链接粘贴到相同的设置中 在关闭浏览器窗口之前。

MCP显示已连接，但未显示工具

这通常是客户端会话缓存问题。

执行以下操作：

• 完全退出MCP客户端
• 重新打开它
• 开始新的会话

研究成果薄弱或空洞

尝试更窄的查询。

更好：

• swiftui image loading
• swiftui asyncimage
• ios monetization

通常较弱：

• AI for work
• coding
• productivity

GUI客户端仍然无法启动服务器

使用绝对命令路径，而不是 substack-mcp-plus.

发展

在项目venv中安装可编辑的Python依赖项：

./venv/bin/python -m pip install -e '.[dev]'

运行测试：

./venv/bin/python -m pytest -q

直接运行服务器：

node src/index.js

安全

• 不要提交令牌、密码或私钥。
• 比起硬编码的凭据，更喜欢交互式设置。
• 存储的浏览器会话数据在下加密 ~/.substack-mcp-plus/.
• 在配置和示例中使用明显的占位符。
• 如果存储的Substack会话过期，请重新运行身份验证。

看 安全.md 用于项目安全说明。

许可证

麻省理工学院