Skip to main content
Glama
deenesjakoruzh
sandraschi

substack-mcp

by sandraschi
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
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

기사 댓글 읽기 및 토론 응답 초안 준비

📁 하위 패키지 문서

📄 라이선스

이 프로젝트는 MIT License에 따라 배포됩니다.

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • VibeSEO

    SEO research, audits, backlinks, GSC, and content workflow tools for AI agents.

  • Notipo

    Publish to self-hosted WordPress from AI agents: markdown, images, SEO, and Notion sync.

  • Kordi — Subscription Intelligence

    Track, analyze, and act on your streaming and SaaS subscriptions from any AI agent.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/substack-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server