Official Substack / Medium MCP Server

Claude 向け Writer Context Tool

Claude を Substack や Medium での執筆内容に接続する、オープンソースの Model Context Protocol（MCP）実装です。

これは何ですか？

Writer Context Tool は、Claude が Substack や Medium などのプラットフォームに投稿した文章にアクセスし、分析できるようにする MCP サーバーです。このツールを使うと、Claude は公開済みコンテンツの文脈を把握し、執筆をよりパーソナライズして支援できます。

機能

• 🔍 Substack と Medium のブログ投稿を取得し、永続的にキャッシュします
• 🔎 エンベディングを使って、クエリに最も関連するエッセイを見つけます
• 📚 個々のエッセイを、Claude が利用できる個別のリソースとして提供します
• 🧠 執筆内容を対象にセマンティック検索を実行します
• ⚡ 起動時にすべてのコンテンツをプリロードし、エンベディングを生成します

仕組み

このツールは RSS フィードを介して Substack／Medium のブログに接続し、投稿を取得してローカルに永続的にキャッシュします。また、各投稿のエンベディングを生成することで、クエリに最も関連するエッセイを見つけるセマンティック検索を可能にします。

執筆内容について Claude に質問すると、個々のエッセイリソースを使って、既存のコンテンツに基づいた洞察を提供したり、新しいアイデアの展開を支援したりできます。

セットアップ手順（ステップごと）

前提条件

• Python 3.10 以降
• Claude Desktop（最新版）
• 公開済みのコンテンツがある Substack または Medium のアカウント

1. このリポジトリをクローンする

git clone https://github.com/yourusername/writer-context-tool.git
cd writer-context-tool

2. Python 環境をセットアップする

uv を使用する場合（推奨）：

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create virtual environment and install dependencies
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

または、標準の pip を使用する場合：

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

3. ブログを設定する

1. 設定ファイルのサンプルをコピーします：

   cp config.example.json config.json
   

2. config.json を編集し、Substack／Medium の URL を指定します：

   {
     "platforms": [
       {
         "type": "substack",
         "url": "https://yourusername.substack.com",
         "name": "My Substack Blog"
       },
       {
         "type": "medium",
         "url": "https://medium.com/@yourusername",
         "name": "My Medium Blog"
       }
     ],
     "max_posts": 100,
     "cache_duration_minutes": 10080,
     "similar_posts_count": 10
   }
   

   • max_posts：各プラットフォームから取得する投稿の最大数（デフォルト：100）
   • cache_duration_minutes：コンテンツを更新するまでのキャッシュ期間（デフォルト：1 週間、または 10080 分）
   • similar_posts_count：検索時に返す、最も関連性の高い投稿の数（デフォルト：10）

4. Claude Desktop に接続する

1. Claude Desktop の設定ディレクトリを作成します：

   # On macOS
   mkdir -p ~/Library/Application\ Support/Claude/
   

2. 設定ファイルを作成します：

   # Get the absolute path to your uv command
   UV_PATH=$(which uv)
   
   # Create the configuration
   cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << EOF
   {
     "mcpServers": {
       "writer-tool": {
         "command": "${UV_PATH}",
         "args": [
           "--directory",
           "$(pwd)",
           "run",
           "writer_tool.py"
         ]
       }
     }
   }
   EOF
   

   注： uv コマンドで問題が発生した場合は、同梱されている代替のシェルスクリプトを使用できます：

   1. スクリプトに実行権限を付与します：chmod +x run_writer_tool.sh
   2. Claude Desktop の設定を更新し、スクリプトを使用します：

   {
     "mcpServers": {
       "writer-tool": {
         "command": "/absolute/path/to/run_writer_tool.sh",
         "args": []
       }
     }
   }
   

3. Claude Desktop を再起動します

Claude でツールを使う

セットアップが完了すると、Claude Desktop で個々のエッセイをリソースとして利用できるようになります。次の操作ができます：

1. 執筆内容を横断検索する：関連するコンテンツを Claude に探してもらいます

   • 「[specific topic] について論じているエッセイを探して」
   • 「[subject] について何を書いた？」

2. 特定のエッセイを参照する：検索結果に表示された個々のエッセイをクリックしてアクセスします

   • 「[essay title] の全文を表示して」

3. コンテンツを更新する：コンテンツを強制的に更新します

   • 「執筆コンテンツを更新して」

利用可能なツールとリソース

Writer Context Tool が提供するもの：

1. 個別のエッセイリソース：各エッセイが選択可能なリソースになります
2. search_writing：エンベディングを使って最も関連性の高いエッセイを見つけるセマンティック検索ツール
3. refresh_content：設定済みのすべてのプラットフォームからコンテンツを更新し、再キャッシュします

キャッシュの仕組み

このツールは、次の機能を備えた永続キャッシュを実装しています：

1. ディスクキャッシュ：すべてのコンテンツをディスクに保存するため、セッション間で保持されます
2. エンベディング：各エッセイをエンベディングに変換し、セマンティック検索に利用します
3. 選択的な更新：キャッシュ設定に応じて、必要な場合にのみコンテンツを更新します
4. プリロード：起動時にすべてのコンテンツが自動的に更新され、エンベディングが生成されます

トラブルシューティング

問題が発生した場合は、以下を確認してください。

1. Claude Desktop にツールが表示されない場合：

   • Claude Desktop の設定ファイルが正しいことを確認してください
   • 設定内のすべてのパスが絶対パスであることを確認してください
   • Python 環境に必要なパッケージがすべてインストールされていることを確認してください
   • Claude Desktop を再起動してください

2. コンテンツが表示されない場合：

   • config.json 内の Substack／Medium の URL を確認してください
   • 「refresh_content」ツールを試してください
   • ブログが公開されており、投稿が公開されていることを確認してください

3. uv コマンドでエラーが発生する場合：

   • 代わりにシェルスクリプトを使用する方法を試してください
   • uv コマンドがインストールされ、PATH に含まれていることを確認してください

4. 埋め込みに関する問題：

   • 埋め込みモデルに関するエラーが表示される場合は、十分なディスク容量があることを確認してください
   • 埋め込みが正常に動作しない場合は、新規インストールから再実行することを検討してください

ライセンス

このプロジェクトは MIT License の下で利用できます。