Substack MCP

MIT License
  • Linux
  • Apple

Integrations

  • Enables retrieval and search of newsletter posts, podcasts, and recommendations, as well as accessing post content, metadata, user profiles, and subscription information from Substack publications.

サブスタックMCP

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

概要

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

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

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

インストール

前提条件

設定

  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 に次のような質問をすることができます。

利用可能なツール

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

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

プロジェクト構造

  • 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ファイルを参照してください。

謝辞

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Claude のような AI アシスタントが Substack ニュースレターと対話できるようにし、標準化されたインターフェースを介して投稿の取得、コンテンツの検索、著者情報へのアクセスを可能にする MCP サーバー。

  1. 概要
    1. インストール
      1. 前提条件
      2. 設定
    2. 使用法
      1. サーバーの実行
      2. デスクトップ版Claudeの設定
      3. クエリの例
    3. 利用可能なツール
      1. プロジェクト構造
        1. 発達
          1. トラブルシューティング
            1. ライセンス
              1. 謝辞

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.
                  Last updated -
                  1
                  Python
                  Apache 2.0
                • -
                  security
                  -
                  license
                  -
                  quality
                  A specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.
                  Last updated -
                  31
                  1
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that connects AI assistants to SearchAgora, enabling users to search for, discover, and purchase products across the web through natural language conversations.
                  Last updated -
                  Python
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  A MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.
                  Last updated -
                  5
                  TypeScript

                View all related MCP servers

                ID: td4i4nj7ef