Substack MCP Server

🚀 Substack MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、Claudeやその他のAIアシスタントがSubstackのニュースレター、記事、ユーザープロファイルとやり取りできるようにします。

🚀 クイックスタート

このプロジェクトは、Substack API ライブラリをAnthropicのMCPサーバーに変換し、Claudeが以下の操作を行えるようにします。

• ニュースレターの記事、ポッドキャスト、おすすめコンテンツを取得する
• ユーザーのプロファイル情報と購読詳細を取得する
• 記事の内容とメタデータを取得する
• 特定のニュースレター内で記事を検索する
• 複数のSubstackニュースレターを同時に検索する
• カテゴリ別に人気のSubstackニュースレターを見つける

📦 インストール

前提条件

• Python 3.10以上
• Claudeデスクトップ版（テスト用）

インストール手順

# リポジトリをクローンする
git clone https://github.com/Greg-Swiftomatic/substack-mcp-server.git
cd substack-mcp-server

# 仮想環境を設定する
python -m venv venv
source venv/bin/activate  # Windows：venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

またはuvを使用することもできます。

# uvを使用してより高速にインストールする
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

💻 使用例

サーバーを起動する

python substack_mcp.py

Claudeデスクトップ版と接続する

1. Claudeデスクトップ版の設定ファイルを開きます。

   # MacOS
   open ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type %APPDATA%\Claude\mcp*.log
   

2. claude-config.jsonに以下の内容を追加します。

   {
     "context_providers": {
       "substack_mcp": {
         "type": "custom",
         "class": "SubstackMCPProvider",
         "args": {
           "server_url": "http://localhost:1234"
         }
       }
     }
   }
   

ツール

ニュースレター記事を取得する (get_newsletter_posts)

• パラメータ：newsletter_id（必須）
• 戻り値：記事のリストとメタデータを含む辞書
• 応答例：

  {
    "posts": [
      {
        "id": "123",
        "title": "最新科技动态",
        "content": "探索未来科技趋势..."
      }
    ],
    "metadata": {
      "total_count": 10,
      "page": 1
    }
  }
  

ユーザープロファイルを取得する (get_user_profile)

• パラメータ：なし
• 戻り値：ユーザーの詳細情報を含む辞書
• 応答例：

  {
    "user_id": "456",
    "username": "tech_guru",
    "subscriber_count": 10000
  }
  

記事を検索する (search_posts)

• パラメータ：query（必須）、newsletter_id（オプション）
• 戻り値：検索結果のリストとメタデータ
• 応答例：

  {
    "results": [
      {
        "id": "789",
        "title": "AIの未来",
        "contentSnippet": "...人工智能的应用与发展..."
      }
    ],
    "metadata": {
      "total_count": 20,
      "page": 1
    }
  }
  

🔧 開発と貢献

機能ブランチを作成する

# リポジトリをクローンする
git clone https://github.com/Greg-Swiftomatic/substack-mcp-server.git

# 新しい機能ブランチを作成する
git checkout -b feature/amazing-feature

# 変更をコミットする
git commit -m '添加了令人惊叹的功能'

# リモートリポジトリにプッシュする
git push origin feature/amazing-feature

📄 ライセンス

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

👏 謝辞

• NHagar/substack_api — オリジナルのSubstack APIライブラリ
• モデルコンテキストプロトコル — AnthropicのMCP仕様