de en es ja ko ru zh

substack-mcp

Name: substack-mcp
Author: sandraschi

by sandraschi

Overview Schema Source Related Servers Discussions Admin

Python

Local

📰 Substack MCP (`substack-mcp`)

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

Substack 뉴스레터를 위한 FastMCP 3.1+ Model Context Protocol (MCP) 서버와 SOTA React 웹앱 대시보드입니다.

빠른 시작 • 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의 역사, 플랫폼 아키텍처, RSS 엔드포인트, 수익화 전략을 다루는 Substack 입문 가이드 전체를 읽어 보세요.

Related MCP server: Substack Reader MCP Server

⚡ 이중 기능: 검색/읽기 & 초안 작성/발행

substack-mcp는 독자/연구자뿐 아니라 창작자/발행자 모두를 위해 설계되었습니다:

작업 모드	인증 필요 여부	기능 및 특징
🔍 검색 & 읽기 (공개 모드)	로그인 불필요	• 모든 Substack 뉴스레터 도메인의 RSS 피드 수집• 로컬 SQLite에서 전체 텍스트 오프라인 기사 검색• 리더 패널 및 오디오/팟캐스트 상세 정보• 마음에 드는 기사 별표 표시 및 북마크
✍️ 초안 작성 & 발행 (작성자 모드)	`substack.sid` 쿠키 필요	• Substack 포스트 초안 준비, 편집, 업데이트• 페이월(`<!-- paywall -->`)이 포함된 Markdown을 Substack HTML로 변환• 로컬 AI 작문 도우미 (Ollama, LM Studio)• 구독자 성장 지표, 조회 수, 열람률• 포스트 댓글 탐색 및 답글 초안 준비

🚀 온보딩 및 도움말 내장

몇 분 만에 시작할 수 있도록 substack-mcp는 웹앱 안에서 직접 실행할 수 있는 대화형 온보딩과 각종 문서를 제공합니다:

📱 인터랙티브 웹앱 대시보드 (http://127.0.0.1:11164) :
- 온보딩 탭: 단계별 설정 마법사.
- 도움말 및 시스템 진단 탭: API 백엔드(:11163), SQLite DB, Substack 쿠키 인증, 로컬 LLM에 대한 실시간 상태 확인 카드.
- 쿠키 추출기 튜토리얼: 브라우저 DevTools(F12)에서 substack.sid 세션 쿠키를 복사해 설정(Settings)에 저장하는 방법을 보여주는 시각 가이드.
- 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. 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`	기사 댓글 읽기 및 토론 응답 초안 준비

📁 하위 패키지 문서

📖 Substack 입문 가이드 (docs/SUBSTACK_PRIMER.md) — Substack이 무엇인지, 플랫폼 구조, 역사, 생태계를 소개합니다.
🎨 웹앱 대시보드 (webapp/) — Vite, React, Tailwind CSS 구성 및 설정 안내.
⚙️ 백엔드 패키지 (substack_mcp/) — FastAPI, FastMCP 3.1+, 로컬 LLM 연진 및 SQLite 데이터베이스.
🧪 테스트 스위트 (tests/) — Pytest 유닛 테스트 스펙 및 커버리지.
📜 스크립트 (scripts/) — 런처(launcher) 및 프롬프트 생성 유틸리티.
📚 문서 허브 (docs/) — 전체 설정, 온보딩, 및 사용법을 비롯한 문제 해결 가이드.

📄 라이선스

이 프로젝트는 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

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

NarrareachOAuth
io.github.iancarson
Draft, schedule, and analyze content for Substack, Medium, LinkedIn, X, Bluesky, and Threads.
Social Media Marketing Content Management Systems
1
beehiivOAuth
com.beehiiv
Manage beehiiv newsletters, posts, podcasts, community, subscribers, and analytics.
11
Buttondown MCP by usefulapi
io.usefulapi
Read Buttondown subscribers, emails, analytics and automations; add subscribers; write email drafts.
251
Notipo A
io.github.kfuras
Publish to self-hosted WordPress from AI agents: markdown, images, SEO, and Notion sync.
Workplace & Productivity
1314

Related MCP Servers

Substack MCP Server
Content Management Systems Social Media App Automation
danielsimonjr
A
license
B
quality
Not graded
maintenance
Enables interaction with Substack publications through natural conversation, allowing users to create posts with cover images, publish notes, manage content, and retrieve profile information.
Updated a year ago (2025-11-26 05:40 UTC)
8
2 npm
-
Substack Reader MCP Server
Content Management Systems Search App Automation
Kealu-Inc
A
license
Not graded
quality
D
maintenance
Enables users to manage and read Substack content directly within Claude, including listing subscriptions and fetching full post details. It supports searching within newsletters and retrieving recent feeds using authenticated browser cookies.
Updated 10 months ago (2025-12-13 05:22 UTC)
2
MIT
Substack MCP Server
Content Management Systems Social Media Marketing
arthurcolle
A
license
A
quality
F
maintenance
Enables AI tools to programmatically manage Substack content, including creating drafts, publishing posts, and posting to Substack Notes. It supports image uploads, live blogging, and document formatting compatible with Substack's ProseMirror editor.
Updated 8 months ago (2026-02-06 01:19 UTC)
11
9
MIT
Substack API MCP
Content Management Systems Communication
alxgntv
F
license
Not graded
quality
B
maintenance
Enables AI agents to draft, publish, and schedule posts on Substack, bypassing the lack of an official publishing API.
Updated a month ago (2026-09-05 20:41 UTC)
134
-

📰 Substack MCP (substack-mcp)