Substack

🚀 Substack MCP 服务器

本项目是一个为 Substack API 集成 Claude 和其他人工智能助手实现模型上下文协议 (MCP) 的服务器，可助力开发者利用 MCP 协议与 Substack 进行交互，实现新闻简报、帖子等内容的获取与搜索。

🚀 快速开始

此项目实现了支持与 Substack 新闻简报、帖子和作者交互的模型上下文协议 (MCP) 服务器。它利用了 Substack API 库，并通过 MCP 提供其功能。

借助此 MCP 服务器，Claude 可以：

• 获取新闻简报中的文章、播客和推荐内容
• 获取帖子的内容和元数据
• 在新闻简报中搜索帖子
• 获取用户个人资料信息和订阅

✨ 主要特性

• 支持与 Substack 新闻简报、帖子和作者交互。
• 利用 MCP 协议，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 提问如下问题：

• “显示来自 https://stratechery.com/ 的近期文章”
• “请展示这篇文章的内容：https://stratechery.com/2023/the-ai-unbundling/”
• “在 https://stratechery.com/ 中搜索‘AI’”
• “谁是 https://stratechery.com/ 的作者？”

📚 详细文档

可用工具

服务器提供了以下 MCP 工具：

项目结构

• substack_mcp.py：主服务器文件
• config.py：配置文件
• requirements.txt：依赖项列表

开发

克隆仓库

git clone https://github.com/Greg-Swiftomatic/substack-mcp.git
cd substack-mcp

安装依赖项

pip install -r requirements.txt

运行测试

python test_substack_mcp.py

故障排除

1. 查看日志

   # macOS/Linux
   tail -f logs/error.log
   
   # Windows
   type logs\error.log
   

2. 检查配置文件 确保配置文件路径正确，并且语法无误。

3. 重新启动服务器

   python substack_mcp.py restart
   

📄 许可证

项目在 MIT License 下开源。

致谢

感谢以下项目和库的支持：

• Substack API 库
• MCP 协议
• Claude 桌面版