サブスタックMCP

Claude やその他の AI アシスタントとの Substack API 統合用の MCP (モデルコンテキストプロトコル) サーバー。

概要

このプロジェクトは、ClaudeのようなAIアシスタントが標準化されたインターフェースを介してSubstackのニュースレター、投稿、そして著者とやり取りできるようにするModel Context Protocol（MCP）サーバーを実装します。Substack APIライブラリを活用し、その機能をMCPを通じて提供します。

この MCP サーバーを使用すると、Claude は次のことが可能になります。

ニュースレターの投稿、ポッドキャスト、おすすめ情報を取得する
投稿コンテンツとメタデータを取得する
ニュースレター内の投稿を検索する
ユーザープロフィール情報とサブスクリプションを取得する

Related MCP server: systemprompt-mcp-reddit

インストール

前提条件

Python 3.10以上
Claude for Desktop （テスト用）

設定

このリポジトリをクローンします:
git clone https://github.com/Greg-Swiftomatic/substack-mcp.git cd substack-mcp
uvを使用して仮想環境を設定します。
curl -LsSf https://astral.sh/uv/install.sh | sh # Install uv if not already installed uv init . uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
依存関係をインストールします:
uv add "mcp[cli]" substack-api

使用法

サーバーの実行

MCP サーバーを実行します。

python substack_mcp.py

デスクトップ版Claudeの設定

Claude for Desktop の設定ファイルを開きます。
- macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows : %APPDATA%\Claude\claude_desktop_config.json
サーバー構成を追加します:
{ "mcpServers": { "substack": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/substack-mcp", "run", "substack_mcp.py" ] } } }
Claude for Desktop を再起動します。

クエリの例

設定が完了すると、Claude に次のような質問をすることができます。

「 https://stratechery.com/からの最近の投稿を表示」
「この投稿の内容は何ですか： https://stratechery.com/2023/the-ai-unbundling/ 」
「 https://stratechery.com/で「AI」を検索してください」
「 https://stratechery.com/の著者は誰ですか？」

利用可能なツール

サーバーは次の MCP ツールを提供します。

道具	説明
`get_newsletter_posts`	Substackニュースレターから最近の投稿を取得します
`get_post_content`	特定のSubstack投稿の完全なコンテンツを取得します
`search_newsletter`	ニュースレター内の投稿を検索します
`get_author_info`	Substackの著者に関する情報を取得します
`get_newsletter_recommendations`	Substack の出版物に推奨されるニュースレターを取得します
`get_newsletter_authors`	Substackニュースレターの著者を獲得する

プロジェクト構造

substack_mcp.py - メインMCPサーバーの実装
examples/ - クエリと応答の例
docker/ - コンテナ化されたデプロイメント用の Docker 構成

発達

このプロジェクトに貢献するには:

リポジトリをフォークする
機能ブランチを作成する ( git checkout -b feature/amazing-feature )
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

トラブルシューティング

問題が発生した場合:

Claude のログでエラーを確認します。
# macOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
サーバーがビルドされ、エラーなしで実行されることを確認します。
python substack_mcp.py
claude_desktop_config.jsonファイルに正しいパスと構文が含まれていることを確認してください。
Claude for Desktop を完全に再起動してみてください。