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规范