Substack MCP

🚀 Substack MCP サーバ

このプロジェクトは、Model Context Protocol (MCP) を実装したサーバで、Substack API を Claude やその他の AI アシスタントに統合することができます。

🚀 クイックスタート

このサーバを使用することで、Claude などの AI アシスタントは、統一されたインターフェースを介して Substack のニュースレター、記事、著者とやり取りすることができます。

✨ 主な機能

• Claude が Substack のニュースレター記事、ポッドキャスト、おすすめを取得できるようにする
• 記事の内容とメタデータを取得する
• ニュースレター内で記事を検索する
• ユーザーのプロフィール情報と購読内容を取得する

📦 インストール

前提条件

• Python 3.10 以上
• 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  # uv が未インストールの場合はインストール
   uv init .
   uv venv
   source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate
   

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

   uv add "mcp[cli]" substack-api
   

💻 使用例

基本的な使用法

サーバーの起動

MCP サーバーを起動します：

python substack_mcp.py

Claude デスクトップ版の設定

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

   • 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 デスクトップ版を再起動します。

サンプルクエリ

設定が完了したら、Claude に以下のような質問をすることができます：

• 特定のニュースレターの記事リストを取得する
• 記事の詳細情報と内容を表示する
• 特定のトピックやキーワードで検索する
• ユーザーのすべての購読を一覧表示する
• 特定の購読の最新更新を取得する

📚 ドキュメント

プロジェクト構造

substack-mcp/
├── README.md          # プロジェクトドキュメント
├── substack_mcp.py    # メインの MCP サーバー実装
└── requirements.txt   # 依存関係のリスト

🔧 技術詳細

このプロジェクトは Substack API ライブラリ をベースに構築されており、MCP を介してその機能を提供します。

📄 ライセンス

この README にはライセンス情報が含まれていません。

⚠️ 重要提示

すべての API リクエストには有効な認証トークンが必要です。サーバーは安全なネットワーク環境で実行するようにし、API トークンを定期的に更新してセキュリティを強化してください。

以上の手順に従えば、Substack のコンテンツを MCP プロトコルをサポートする任意の AI アシスタントに簡単に統合し、その機能とアプリケーションシナリオを拡張することができます。