Substack MCP

🚀 Substack MCP 服務器

本項目實現了一個支持 Model Context Protocol (MCP) 的服務器，可將 Substack API 集成到 Claude 等 AI 助手中，讓 AI 助手能通過統一接口與 Substack 的時事通訊、文章和作者進行交互，極大地拓展了 AI 助手的信息獲取範圍。

🚀 快速開始

此項目實現了 Model Context Protocol (MCP) 服務器，讓 AI 助手（如 Claude）能通過統一接口與 Substack 時事通訊、文章和作者交互。藉助該服務器，Claude 可獲取時事通訊文章、播客、推薦、文章內容和元數據，還能在時事通訊中搜索文章，獲取用戶個人資料信息和訂閱。

✨ 主要特性

• 統一交互接口：藉助 MCP 服務器，AI 助手如 Claude 能通過統一接口與 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 提問如下問題：

• 獲取具體時事通訊的文章列表
• 查看某文章的詳細信息和內容
• 搜索特定主題或關鍵詞
• 列出用戶的所有訂閱
• 獲取某訂閱的最新更新

📚 詳細文檔

項目結構

substack-mcp/
├── README.md          # 項目文檔
├── substack_mcp.py    # 主 MCP 服務器實現
└── requirements.txt   # 依賴項清單

🔧 技術細節

此項目基於 Substack API 庫，並通過 MCP 提供其功能。它實現了一個 MCP 服務器，使 AI 助手如 Claude 能夠通過統一接口與 Substack 時事通訊、文章和作者交互。

📄 許可證

文檔未提及許可證相關信息。

⚠️ 重要提示

• 所有 API 請求都需要有效的認證令牌。
• 確保服務器在安全的網絡環境中運行。
• 定期更新 API 令牌以增強安全性。

通過以上步驟，你可以輕鬆地將 Substack 內容集成到任何支持 MCP 協議的 AI 助手中，擴展其功能和應用場景。