Skip to main content
Glama
deenesjakoruzh
sandraschi

substack-mcp

by sandraschi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

📰 Substack MCP (substack-mcp)

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

FastMCP 3.1+ Model Context Protocol（MCP）サーバーと、Substackニュースレター向けの最先端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 Primer Guide をお読みください。

Related MCP server: Substack Reader MCP Server

⚡ デュアル機能:検索・閲覧と下書き・公開

substack-mcp は、読者／研究者とクリエイター／パブリッシャーの両方を対象に設計されています。

Workflow Mode

認証は必要？

機能と特長

🔍 検索・閲覧 (パブリックモード)

ログイン不要

• 任意のSubstackニュースレターのRSSフィードを取り込む• ブロック内SQLiteで記事全文のオフライン検索• リーダーペインと音声／ポッドキャスト詳細• お気に入り記事のスター付け＆ブックマーク

✍️ 下書き・公開 (著者モード)

substack.sid Cookieが必要

• Substack投稿の下書きを準備・編集・更新• Markdownをペイウォール付きSubstack HTMLに変換（<!-- paywall -->）• ローカルAIライティングアシスタント（Ollama、LM Studio）• 購読者成長指標、閲覧数、開封率• 投稿コメントの閲覧と返信の準備

🚀 組み込みのオンボーディングとヘルプ

数分でセットアップできるよう、substack-mcp にはウェブアプリ内およびドキュメント内に直接インタラクティブなオンボーディングが含まれています。

  • 📱 インタラクティブなウェブアプリダッシュボード（http://127.0.0.1:11164）:

    • オンボーディングタブ: ステップバイステップのセットアップウィザード

    • ヘルプとシステム診断タブ: APIバックエンド（:11163）、SQLite DB、Substack Cookie 認証、ローカルLLMのライブヘルスチェックカード。

    • Cookie抽出チュートリアル: ブラウザDevTools（F12）から substack.sid セッションCookieをコピーして日々設定に貼り付けるビジュアルガイド。

    • MCPクライアント統合スニペット: Google Antigravity、Claude Desktop、Cursor向けのWebキーでコピー＆ペーストできるエンドポイント。

  • 📚 リポジトリガイド: 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

🛠️ 複合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 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

Related MCP Connectors

Related MCP Servers