Official Substack MCP Server

🚀 写作コンテキストツール for Claude

Claudeは、SubstackやMediumでの執筆に関するコンテキストを提供するためのオープンソースのモデルコンテキストプロトコル（MCP）を実装しています。このツールを使うことで、Claudeはあなたの執筆内容をより深く理解し、より個別化された支援を提供できます。

🚀 クイックスタート

Claude用の写作コンテキストツールは、SubstackやMediumで公開した記事のコンテキストをClaudeに提供するためのMCPサーバーです。これにより、Claudeはあなたの執筆内容を理解し、より個別化されたアドバイスを提供できます。

✨ 主な機能

• 🔍 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を使用する場合（推奨）：

# uvがない場合はインストールする
curl -LsSf https://astral.sh/uv/install.sh | sh

# 仮想環境を作成し、依存関係をインストールする
uv venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate
uv pip install -r requirements.txt

標準のpipを使用する場合：

python -m venv .venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate
pip install -r requirements.txt

3. ブログを設定する

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

cp config.json.example config.json

2. config.json の値を必要に応じて編集します。特に content_refresh_interval と embedding_model_choice を設定します。

4. ツールを実行する

写作コンテキストツールを起動します：

python run.py

💻 使用例

基本的な使用法

インストールが完了すると、Claude Desktopにあなたの記事がリソースとして表示されます。以下の操作が可能です：

1. あなたの作品を検索する：Claudeに関連するコンテンツを検索させます。

   • "〔特定のトピック〕について議論している記事を見つけて"
   • "〔トピック〕について私は何を書いた？"

2. 単一の記事を参照する：検索結果の記事をクリックして、完全なテキストにアクセスします。

   • "〔記事のタイトル〕の全文を表示"

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

   • "私の執筆内容を更新"

📚 ドキュメント

キャッシュの仕組み

このツールは永続的なキャッシュを実装しており、以下の機能を持っています：

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ライセンスの下で利用可能です。