Substack MCP

一个用于 Substack API 集成 Claude 和其他 AI 助手的 MCP (模型上下文协议) 服务器。

概述

本项目实现了一个模型上下文协议 (MCP) 服务器，该服务器使像 Claude 这样的 AI 助手能够通过标准化接口与 Substack 新闻通讯、帖子和作者进行交互。它利用 Substack API 库，并通过 MCP 提供其功能。

通过此 MCP 服务器，Claude 可以：

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

安装

前提条件

• Python 3.10 或更高版本
• Claude for Desktop (用于测试)

设置

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
   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 for Desktop

1. 打开 Claude for Desktop 的配置文件：

   • 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 for Desktop。

示例查询

配置完成后，您可以向 Claude 提出如下问题：

• "Show me recent posts from https://stratechery.com/" (显示来自 https://stratechery.com/ 的最新帖子)
• "What's the content of this post: https://stratechery.com/2023/the-ai-unbundling/" (此帖子的内容是什么：https://stratechery.com/2023/the-ai-unbundling/)
• "Search for 'AI' on https://stratechery.com/" (在 https://stratechery.com/ 上搜索 'AI')
• "Who are the authors of https://stratechery.com/?" (https://stratechery.com/ 的作者是谁？)

可用工具

服务器提供以下 MCP 工具：

工具	描述
get_newsletter_posts	检索 Substack 新闻通讯的最新帖子
get_post_content	获取特定 Substack 帖子的完整内容
search_newsletter	在新闻通讯中搜索帖子
get_author_info	获取有关 Substack 作者的信息
get_newsletter_recommendations	获取 Substack 出版物的推荐新闻通讯
get_newsletter_authors	获取 Substack 新闻通讯的作者

项目结构

• substack_mcp.py - 主要的 MCP 服务器实现
• examples/ - 示例查询和响应
• docker/ - 用于容器化部署的 Docker 配置

开发

要为此项目做出贡献：

1. Fork 存储库
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

故障排除

如果您遇到问题：

1. 检查 Claude 的日志以查找错误：

   # macOS/Linux
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type %APPDATA%\Claude\Logs\mcp*.log
   

2. 验证您的服务器是否构建并运行没有错误：

   python substack_mcp.py
   

3. 确保您的 claude_desktop_config.json 文件具有正确的路径和语法。

4. 尝试完全重新启动 Claude for Desktop。

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• Substack API - 用于 Substack 交互的底层库
• 模型上下文协议 - Anthropic 用于标准化 LLM 集成的协议