Substack MCP Server

🚀 Substack MCP 服務器

Substack MCP 服務器是一個模型上下文協議（MCP）服務器，它讓Claude和其他人工智能助手能夠與Substack新聞通訊、文章以及用戶資料進行交互，為AI使用Substack數據提供了便捷途徑。

🚀 快速開始

該項目把Substack API 庫轉換成了Anthropic的MCP服務器，讓Claude可以實現以下功能：

• 獲取新聞通訊文章、播客和推薦內容
• 獲取用戶個人資料信息和訂閱詳情
• 獲取文章內容和元數據
• 搜索特定新聞通訊中的文章
• 跨多個Substack新聞通訊同時搜索
• 按類別發現熱門的Substack新聞通訊

✨ 主要特性

• 支持Claude與Substack的多種數據交互，如文章、用戶資料等。
• 提供跨多個新聞通訊的搜索功能以及按類別發現熱門通訊的能力。

📦 安裝指南

先決條件

• Python 3.10或更高版本
• Claude桌面版（用於測試時）

安裝步驟

# 克隆倉庫
git clone https://github.com/Greg-Swiftomatic/substack-mcp-server.git
cd substack-mcp-server

# 設置虛擬環境
python -m venv venv
source venv/bin/activate  # Windows：venv\Scripts\activate

# 安裝依賴項
pip install -r requirements.txt

或者使用uv：

# 使用uv進行更快的安裝
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

💻 使用示例

運行服務器

python substack_mcp.py

與Claude桌面版連接

1. 打開你的Claude桌面版配置文件：

   # MacOS
   open ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type %APPDATA%\Claude\mcp*.log
   

2. 添加以下內容到claude-config.json：

   {
     "context_providers": {
       "substack_mcp": {
         "type": "custom",
         "class": "SubstackMCPProvider",
         "args": {
           "server_url": "http://localhost:1234"
         }
       }
     }
   }
   

工具使用示例

基礎用法

獲取新聞通訊文章 (get_newsletter_posts)

• 參數：newsletter_id（必需）
• 返回值：包含文章列表和元數據的字典
• 示例響應：

  {
    "posts": [
      {
        "id": "123",
        "title": "最新科技動態",
        "content": "探索未來科技趨勢..."
      }
    ],
    "metadata": {
      "total_count": 10,
      "page": 1
    }
  }
  

獲取用戶資料 (get_user_profile)

• 參數：無
• 返回值：包含用戶詳細信息的字典
• 示例響應：

  {
    "user_id": "456",
    "username": "tech_guru",
    "subscriber_count": 10000
  }
  

搜索文章 (search_posts)

• 參數：query（必需），newsletter_id（可選）
• 返回值：包含搜索結果的列表和元數據
• 示例響應：

  {
    "results": [
      {
        "id": "789",
        "title": "AI的未來",
        "contentSnippet": "...人工智能的應用與發展..."
      }
    ],
    "metadata": {
      "total_count": 20,
      "page": 1
    }
  }
  

📚 詳細文檔

開發和貢獻

創建功能分支

# 克隆倉庫
git clone https://github.com/Greg-Swiftomatic/substack-mcp-server.git

# 創建新功能分支
git checkout -b feature/amazing-feature

# 提交更改
git commit -m '添加了令人驚歎的功能'

# 推送到遠程倉庫
git push origin feature/amazing-feature

📄 許可證

本項目根據MIT License授權，具體內容請參閱LICENSE文件。

致謝

• NHagar/substack_api——原始的Substack API庫
• 模型上下文協議——Anthropic的MCP規範