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 助手中，扩展其功能和应用场景。