📰 Substack MCP (substack-mcp)

FastMCP 3.1+ Model Context Protocol (MCP)-Server und SOTA-React-Webapp-Dashboard für Substack-Newsletter.

Schnellstart • Was ist Substack? • Duale Fähigkeiten • Onboarding • just-Befehle • Dokumentation

🧠 Was ist Substack?

Substack ist eine unabhängige Publikationsplattform und ein Creator-Netzwerk, das 2017 gegründet wurde. Sie ermöglicht Autor:innen, Journalist:innen, Forscher:innen, Podcaster:innen und Denker:innen, Longform-Newsletter direkt in die E-Mail-Postfächer ihrer Leser:innen und ins Web zu veröffentlichen.

+-----------------------------------------------------------------------------------+
|                              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) |
+---------+     +------------------+           +-------------------+    +-------------------+

📖 Tiefer eintauchen? Lies unseren vollständigen Substack Primer Guide mit Substacks Geschichte, Plattformarchitektur, RSS-Endpunkten und Monetarisierungsstrategien.

Related MCP server: Substack Reader MCP Server

⚡ Duale Fähigkeiten: Suchen/Lesen & Entwurf/Veröffentlichen

substack-mcp ist für beide Zielgruppen konzipiert: Leser:innen/Forschende und Creator/Publizierende:

🚀 Integriertes Onboarding & Hilfe

Damit du in wenigen Minuten einsatzbereit bist, enthält substack-mcp ein interaktives Onboarding direkt in der Webapp und in der Dokumentation:

• 📱 Interaktives Webapp-Dashboard (http://127.0.0.1:11164):

  • Onboarding-Tab: Schritt-für-Schritt-Setup-Assistent.

  • **Tab * Hilfe & Systemdiagnose **: Live-Gesundheits-Check-Karten für das API-Backend (:11163), die SQLite-Datenbank, die Substack-Cookie-Authentifizierung und lokale LLMs.

  • Cookie-Extractor-Tutorial: Visuelle Anleitung, wie du dein substack.sid-Session-Cookie aus den Browser-DevTools (F12) in die Einstellungen übernimmst.

  • MCP-Client-Integrations-Snippets: Ein-Klick-Endpunkte für Google Antigravity, Claude Desktop und Cursor.

• 📚 Repo-Anleitungen: Siehe INSTALL.md und docs/ONBOARDING.md.

⚙️ just-Task-Runner-Befehle

Alle typischen Aufgaben sind im Repository justfile definiert:

# 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

⚡ Schnellstart

1. Server und Webapp-Dashboard starten

# 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

Das Webapp-Dashboard öffnet sich automatisch in deinem Standard-Browser unter http://127.0.0.1:11164.

2. KI-Assistenten verbinden (Google Antigravity Claude Desktop)

Richte deine MCP-Client-Konfiguration auf den FastMCP-Streamable-HTTP-Endpunkt aus:

http://127.0.0.1:11163/mcp

🛠️ Portmanteau-MCP-Tools

📁 Sub-Package-Dokumentation

• 📖 Substun Primer Guide (docs/SUBSTACK_PRIMER.md) — Was Substack ist, Plattformstruktur, Geschichte und Ökosystem.

• 🎨 Webapp-Dashboard (webapp/) — Einrichtung von Vite, React, Tailwind CSS und Biome.

• ⚙️ Backend-Paket (substack_mcp/) — FastAPI, FastMCP 3.1+, lokale-LLM-Engine und SQLite-Datenbank.

• 🧪 Test-Suite (tests/) — Pytest-Testspezifikationen und Abdeckung.

• 📜 Skripte (scripts/) — Launcher für Flottengeräte und Dienstprogramme zur Promptgenerierung.

• 📚 Dokumentations-Hub (docs/) — Vollständige Konfigurations-, Onboarding-, Tool- und Troubleshooting-Anleitungen.

📄 Lizenz

Veröffentlicht unter der MIT-Lizenz.