Substack

🚀 Substack MCP サーバー

このサーバーは、Substack API とClaudeやその他のAIアシスタントを統合するためのモデルコンテキストプロトコル (MCP) を実装しています。

🚀 クイックスタート

このプロジェクトは、Substackのニュースレター、記事、著者とのやり取りをサポートするモデルコンテキストプロトコル (MCP) サーバーを実装しています。Substack API ライブラリ を利用し、MCP を通じてその機能を提供します。

この MCP サーバーを使用することで、Claude は以下のことができます。

• ニュースレター内の記事、ポッドキャスト、おすすめコンテンツを取得する
• 記事の内容とメタデータを取得する
• ニュースレター内で記事を検索する
• ユーザーのプロフィール情報と購読情報を取得する

✨ 主な機能

• Substack API とClaudeやその他のAIアシスタントを統合するためのモデルコンテキストプロトコル (MCP) を実装
• Substackのニュースレター、記事、著者とのやり取りをサポート
• Claudeを使ってニュースレター内の記事、ポッドキャスト、おすすめコンテンツを取得
• 記事の内容とメタデータを取得
• ニュースレター内で記事を検索
• ユーザーのプロフィール情報と購読情報を取得

📦 インストール

前提条件

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

• “https://stratechery.com/ からの最近の記事を表示”
• “この記事の内容を表示してください：https://stratechery.com/2023/the-ai-unbundling/”
• “https://stratechery.com/ で‘AI’を検索”
• “https://stratechery.com/ の著者は誰ですか？”

📚 ドキュメント

利用可能なツール

サーバーは以下の MCP ツールを提供しています。

プロジェクト構造

• substack_mcp.py：メインのサーバーファイル
• config.py：設定ファイル
• requirements.txt：依存関係のリスト

開発

リポジトリのクローン

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

依存関係のインストール

pip install -r requirements.txt

テストの実行

python test_substack_mcp.py

トラブルシューティング

1. ログの確認

   # macOS/Linux
   tail -f logs/error.log
   
   # Windows
   type logs\error.log
   

2. 設定ファイルの確認 設定ファイルのパスが正しく、構文に誤りがないことを確認してください。

3. サーバーの再起動

   python substack_mcp.py restart
   

📄 ライセンス

このプロジェクトは MIT License の下でオープンソース化されています。

謝辞

以下のプロジェクトとライブラリのサポートに感謝します。

• Substack API ライブラリ
• MCP プロトコル
• Claude デスクトップ版