サブスタック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 （テスト用）

設定

1. このリポジトリをクローンします:

   git clone https://github.com/Greg-Swiftomatic/substack-mcp.git
   cd substack-mcp

2. 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

3. 依存関係をインストールします:

   uv add "mcp[cli]" substack-api

使用法

サーバーの実行

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

python substack_mcp.py

デスクトップ版Claudeの設定

1. Claude for Desktop の設定ファイルを開きます。

   • macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows : %APPDATA%\Claude\claude_desktop_config.json

2. サーバー構成を追加します:

   {
       "mcpServers": {
           "substack": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/substack-mcp",
                   "run",
                   "substack_mcp.py"
               ]
           }
       }
   }

3. Claude for Desktop を再起動します。

クエリの例

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

• 「 https://stratechery.com/からの最近の投稿を表示」

• 「この投稿の内容は何ですか： https://stratechery.com/2023/the-ai-unbundling/ 」

• 「 https://stratechery.com/で「AI」を検索してください」

• 「 https://stratechery.com/の著者は誰ですか？」

利用可能なツール

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

プロジェクト構造

• substack_mcp.py - メインMCPサーバーの実装

• examples/ - クエリと応答の例

• docker/ - コンテナ化されたデプロイメント用の Docker 構成

発達

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

1. リポジトリをフォークする

2. 機能ブランチを作成する ( git checkout -b feature/amazing-feature )

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

トラブルシューティング

問題が発生した場合:

1. Claude のログでエラーを確認します。

   # macOS/Linux
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type %APPDATA%\Claude\Logs\mcp*.log

2. サーバーがビルドされ、エラーなしで実行されることを確認します。

   python substack_mcp.py

3. claude_desktop_config.jsonファイルに正しいパスと構文が含まれていることを確認してください。

4. Claude for Desktop を完全に再起動してみてください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

• Substack API - Substackインタラクションの基礎となるライブラリ

• モデルコンテキストプロトコル- 標準化された LLM 統合のための Anthropic のプロトコル