📰 Substack MCP (substack-mcp)

Servidor FastMCP 3.1+ de Model Context Protocol (MCP) y panel web en React de última generación para newsletters de Substack.

Inicio rápido • ¿Qué es Substack? • Capacidades duales • Onboarding • Comandos de just • Documentación

🧠 ¿Qué es Substack?

Substack es una plataforma de publicación independiente y una red de creadores fundada en 2017. Permite a escritores, periodistas, investigadores, podcasters y pensadores publicar newsletters de largo formato directamente en las bandejas de entrada de sus lectores y en la web.

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

📖 ¿Quieres un análisis más profundo? Lee nuestra Guía de Substack Primer completa, que cubre la historia de Substack, la arquitectura de la plataforma, los endpoints RSS y las estrategias de monetización.

Related MCP server: Substack Reader MCP Server

⚡ Capacidades duales: Búsqueda/Lectura y Borrador/Publicación

substack-mcp está diseñado tanto para lectores/investigadores como para creadores/publicadores:

🚀 Onboarding integrado y ayuda

Para que te pongas en marcha en minutos, substack-mcp incluye un onboarding interactivo directamente dentro de la webapp y de la documentación:

• 📱 Panel de la webapp interactivo (http://127.0.0.1:11164):

  • Pestaña Onboarding: asistente de configuración paso a paso.

  • Pestaña Ayuda y Diagnóstico del Sistema: tarjetas de comprobación en vivo para el Backend de la API (:11163), la base de datos SQLite, la cookie Auth de Substack y los LLM locales.

  • Tutorial de extracción de cookies: guía visual para copiar tu cookie de sesión substack.sid desde las DevTools del navegador (F12) dentro de Ajustes.

  • Fragmentos de integración de clientes MCP: puntos de conexión de un clic para Google Antigravity, Claude Desktop y Cursor.

• 📚 Guías del repositorio: consulte INSTALL.md y docs/ONBOARDING.md.

⚙️ Comandos del ejecutor de tareas just

Todas las tareas comunes están definidas en el justfile del repositorio:

# 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

⚡ Inicio rápido

1. Inicie el servidor y el panel de la webapp

# 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

El panel de la webapp se abrirá automáticamente en tu navegador predeterminado en http://127.0.0.1:11164.

2. Conecte los asistentes de IA (Google Antigravity / Claude Desktop)

Apunta la configuración de tu cliente MCP al endpoint HTTP FastMCP Streamable:

http://127.0.0.1:11163/mcp

🛠️ Herramientas MCP Portmanteau

📁 Documentación del subpaquete

• 📖 Guía de Substack Primer (docs/SUBSTACK_PRIMER.md) — Qué es Substack, estructura de la plataforma, historia y ecosistema.

• 🎨 Panel de la webapp (webapp/) — Configuración de Vite, React, Tailwind CSS y Biome.

• ⚙️ Paquete backend (substack_mcp/) — FastAPI, FastMCP 3.1+, motor de LLM local y base de datos SQLite.

• 🧪 Suite de pruebas (tests/) — Especificaciones de test unitarios de Pytest y cobertura.

• 📜 Scripts (scripts/) — Utilidades lanzador de grupo y generación de prompts.

• 📚 Centro de documentación (docs/) — Guías completas de configuración, onboarding, herramientas y resolución de problemas.

📄 Licencia

Distribuido bajo la licencia MIT.