Official Substack MCP Server

🚀 寫作上下文工具為Claude

Claude連接到您的Substack和Medium寫作的開放源代碼模型上下文協議（MCP）實現。本工具能讓Claude訪問並分析您在Substack和Medium發表的文章，理解發布內容的上下文，為您提供更個性化的寫作幫助。

🚀 快速開始

寫作上下文工具是一個MCP服務器，它允許Claude訪問並分析您從Substack和Medium發表的文章。藉助該工具，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. search_writing：一種語義搜索工具，使用嵌入找到最相關的文章
3. refresh_content：刷新並重新緩存所有配置平臺上的內容

🔧 技術細節

工作原理

工具通過RSS feeds連接到您的Substack/Medium博客，獲取文章並本地永久緩存。同時為每篇文章生成嵌入式，實現基於查詢的語義搜索以找到最相關的文章。當您詢問Claude關於您的寫作時，它可以使用這些單篇論文資源為您提供見解或幫助您根據現有內容開發新想法。

緩存工作原理

工具實現永久緩存，具有以下功能：

1. 磁盤緩存：所有內容都存儲在磁盤上，因此在會話之間持久存在
2. 嵌入式：每篇文章轉換為嵌入以進行語義搜索
3. 選擇性刷新：工具根據您的緩存設置僅刷新所需內容
4. 預加載：啟動時自動刷新所有內容並生成嵌入

📄 許可證

此項目在MIT License下可用。

常見問題

如果您遇到問題：

1. 工具未顯示在Claude Desktop中：
   • 檢查您的Claude Desktop配置文件是否正確
   • 確保配置中的所有路徑都是絕對路徑
   • 確保Python環境安裝了所有必需的包
   • 重新啟動Claude Desktop
2. 沒有內容顯示：
   • 驗證config.json中的Substack/Medium URL
   • 嘗試使用"refresh_content"工具
   • 檢查您的博客是否公開且有已發佈文章
3. uv命令錯誤：
   • 嘗試使用shell腳本方法
   • 確認uv命令已安裝並在PATH中
4. 嵌入式問題：
   • 如果看到有關嵌入式模型的錯誤，請確保有足夠的磁盤空間
   • 考慮重新運行以獲得更好的效果如果嵌入式未正確工作