📰 Substack MCP (substack-mcp)

Сервер FastMCP 3.1+ Model Context Protocol (MCP) и современная React-панель для новостных рассылок Substack.

Быстрый старт • Что такое 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-mcp включает интерактивный онбординг прямо в веб-приложении и в документации:

• 📱 Интерактивная веб-панель (http://127.0.0.1:11164):

  • Вкладка «Онбординг»: пошаговый мастер настройки.

  • Вкладка «Помощь и диагностика»: живые карточки проверки состояния API Backend (:11163), базы данных SQLite, авторизации через cookie Substack и локальных LLM.

  • Обучающее руководство по извлечению cookie: наглядный гайд по копированию сессионной cookie substack.sid из инструментов разработчика браузера (F12) в настройки.

  • Сниппеты интеграции с 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. Запустите сервер и веб-панель

# 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

Веб-панель автоматически откроется в вашем браузере по умолчанию по адресу http://127.0.0.1:11164.

2. Подключите ИИ-ассистентов (Google Antigravity / Claude Desktop)

Укажите в конфигурации вашего MCP-клиента endpoint FastMCP Streamable HTTP:

http://127.0.0.1:11163/mcp

🛠️ Комбинированные MCP-инструменты

📁 Документация под-пакетов

• 📖 Руководство по Substack (docs/SUBSTACK_PRIMER.md) — что такое Substack, устройство платформы, история и экосистема.

• 🎨 Веб-панель (webapp/) — настройка Vite, React, Tailwind CSS и Biome.

• ⚙️ Бэкенд-пакет (substack_mcp/) — FastAPI, FastMCP 3.1+, локальный LLM-движок и база данных SQLite.

• 🧪 Тестовый набор (tests/) — спецификации pytest-тестов и покрытие.

• 📜 Скрипты (scripts/) — запуск групп программ и утилиты генерации промптов.

• 📚 Центр документации (docs/) — полные руководства по настройке, онбордингу, инструментам и устранению неполадок.

📄 Лицензия

Распространяется под лицензией MIT.