Skip to main content
Glama
deenesjakoruzh
sandraschi

substack-mcp

by sandraschi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

📰 Substack MCP (substack-mcp)

CI Status Python Version FastMCP Version FastAPI React Vite Tailwind CSS just Ruff Biome Pyright Tauri License

FastMCP 3.1+ Model Context Protocol (MCP) 服务器与面向 Substack 新闻通讯的先进 React Web 应用仪表盘。

快速开始 • 什么是 Substack？ • 双重能力：搜索/阅读与草稿/发布 • 内置引导与帮助 • just 任务命令 • 文档

🧠 什么是 Substack？

Substack 是一个创立于 2017 年的独立发布平台与创作者网络。它让作家、记者、研究者、播客主和思想者能够将长篇新闻通讯直接发布到读者的电子邮箱和网络端。

+-----------------------------------------------------------------------------------+
|                              Substack Publication                                 |
+----------------------------------------+------------------------------------------+
                                         |
     +-------------------+---------------+---------------+--------------------+
     |                   |                               |                    |
     v                   v                               v                    v
+---------+     +------------------+           +-------------------+    +-------------------+
|  Posts  |     | Substack Notes   |           |  Substack Chat    |    | Subscriber Tiers  |
| (Email  |     | (Short-form      |           | (Community        |    | (Free, Monthly,   |
| + Web)  |     |  Social Feed)    |           |  Messaging)       |    |  Annual, Founder) |
+---------+     +------------------+           +-------------------+    +-------------------+

📖 想深入了解吗？ 请阅读完整的 Substack 入门指南，其中涵盖 Substack 的历史、平台架构、RSS 端点以及货币化策略。

Related MCP server: Substack Reader MCP Server

⚡ 双重能力：搜索与阅读 / 草稿与发布

substack-mcp 专为读者/研究者与创作者/发布者两类用户而设计：

工作流模式

是否需要认证？

能力与特点

🔍 搜索与阅读 （公开模式）

无需登录

• 从任意 Substack 新闻通讯域名摄取 RSS feed• 在本地 SQLite 中离线全文搜索文章• 阅读面板与音频/播客详情• 将喜欢的文章加星标与收藏

✍️ 草稿与发布 （作者模式）

需要 substack.sid Cookie

• 暂存、编辑、更新 Substack 文章草稿• 将 Markdown 转换为带有付费发文（<!-- paywall -->）的 Substack HTML• 本地 AI 写作助手（Ollama、LM Studio）• 订阅者增长指标、阅读量和打开率• 浏览文章评论并暂存回复

🚀 内置安装引导与帮助

为了让您在几分钟内快速上手，substack-mcp 在 Web 应用和文档中内置了交互式引导：

  • 📱 交互式 Web 应用仪表盘（http://127.0.0.1:1164）：

    • “引导”标签页：分步设置向导。

    • “帮助与系统诊断”标签页：提供 API 后端（:11164）、SQLite 数据库、Substack Cookie 认证和本地 LLM 的动态健康检查卡片。

    • “Cookie 提取教程”：可视化指南，教你如何从浏览器开发者工具（F12）中复制 substack.sid 会话 Cookie 到设置页面。

    • MCP 客户端集成代码片段：一键获取 Google Antigravity、Claude Desktop 和 Cursor 的接入端点。

  • 📚 仓库指南：参见 INSTALL.md 和 docs/ONBOARDING.md。

⚙️ just 任务运行器命令

仓库中的所有常见任务均定义在 justfile 中：

# Run full quality check (lint + typecheck + pytest)
just check

# Run Python Pytest test suite
just test

# Lint backend (ruff) and webapp (biome)
just lint

# Format code (ruff format & biome format)
just format

# Static typecheck (pyright & tsc)
just typecheck

# Start unified dev servers (clears zombie ports, starts backend & webapp, opens browser)
just start

# Pack .mcpb desktop package
just mcpb-pack

# Build Tauri NSIS Windows installer
just tauri-build

# Run headless CUA smoke test
just cua-smoke

⚡ 快速开始

1. 启动服务器与 Web 应用仪表盘

# Clone the repository
git clone https://github.com/sandraschi/substack-mcp.git
cd substack-mcp

# Launch backend (11163) and dashboard (11164) via just or PowerShell script
just start
# or: .\start.ps1

Web 应用仪表盘将自动在您默认浏览器的 http://127.0.0.1:11164 地址打开。

2. 连接 AI 助手（Google Antigravity / Claude Desktop）

将您的 MCP 客户端配置指向 FastMCP Streamable HTTP 端点：

http://127.0.0.1:11163/mcp

🛠️ Portmanteau MCP 工具集

工具

操作

描述

substack_feed

fetch, list_publications, query, get_article

摄取 RSS，列出已跟踪的新闻通讯，搜索文章

substack_drafts

create, list, get, update, delete, convert_markdown

暂存草稿，编辑内容，渲染 Markdown HTML

substack_stats

record, get, summary

跟踪订阅者指标、文章阅读量和打开率

substack_community

get_comments, post_comment

阅读文章评论，暂存讨论回复

📁 子包文档

📄 许可证

基于 MIT License 发布。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers