AI导哈

Substack阅读器MCP服务器

一个用于从Claude Code读取Substack订阅内容的MCP（Model Context Protocol）服务器。

  • by Kealu-Inc
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Kealu-Inc/substack-reader-mcp

使用说明

子组读取器MCP服务器

一个MCP（模型上下文协议）服务器，用于从Claude Code读取您的Substack订阅。

安装

# Clone the repo
git clone git@github.com:Kealu-Inc/substack-reader-mcp.git ~/.claude/mcp-servers/substack-reader

# Run setup
cd ~/.claude/mcp-servers/substack-reader
make setup

特性

  • list_订阅 -列出您订阅的所有新闻通讯
  • 获取饲料 -获取您所有订阅的最新帖子
  • get_recent_posts -从特定的时事通讯中获取帖子
  • read_post -阅读任何帖子的全部内容
  • 搜索_通讯 -在时事通讯中搜索

快速开始

cd ~/.claude/mcp-servers/substack-reader
make setup

这将：

  1. 安装Python依赖项
  2. 引导您导出浏览器Cookie
  3. 配置您的Substack用户名
  4. 将MCP服务器添加到Claude Code设置中
  5. 测试连接

手动设置

1.安装依赖项

make install

2.导出子组Cookie

  1. 安装 Cookie编辑器 浏览器扩展
  2. 登录到 substack.com
  3. 单击Cookie编辑器→ 出口→ 导出为JSON
  4. 保存到 ~/.config/substack-reader/cookies.json

3.配置用户名

创建 ~/.config/substack-reader/config.json:

{
  "username": "your-substack-username"
}

您的用户名来自您的Substack配置文件URL（例如。， substack.com/@username).

4.配置克劳德代码

运行：

make configure

或手动添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "substack-reader": {
      "command": "python3",
      "args": ["/path/to/substack-reader/server.py"],
      "env": {
        "SUBSTACK_USERNAME": "your-username",
        "SUBSTACK_COOKIES_PATH": "/path/to/cookies.json"
      }
    }
  }
}

5.重新启动克劳德代码

MCP服务器将在重新启动时加载。

使用示例

设置后，问克劳德：

  • “列出我的Substack订阅”
  • “获取我的订阅源”
  • “获取The Pragmatic Engineer的最新帖子”
  • “阅读关于系统设计的最新帖子”
  • “在工程领导力中寻找‘微服务’”

测试

make test

故障排除

“未找到订阅”

  • 验证您的用户名是否正确
  • 检查Cookie是否正确导出（应包括 substack.sid)

“身份验证错误”

  • 从浏览器重新导出Cookie（可能已过期）
  • 导出时确保您已登录Substack

MCP服务器未加载

  • 检查 ~/.claude/settings.json 语法是有效的JSON
  • 验证服务器路径是否正确
  • 完全重新启动Claude代码

文件

~/.claude/mcp-servers/substack-reader/
├── server.py          # Main MCP server
├── setup.py           # Interactive setup wizard
├── Makefile           # Setup automation
├── scripts/
│   ├── configure_claude.py
│   └── test_server.py
└── README.md

~/.config/substack-reader/
├── config.json        # Username configuration
└── cookies.json       # Browser cookies (keep private!)

安全

  • 永远不要提交cookies.json -它包含您的会话
  • Cookie定期过期-身份验证失败时重新导出
  • 服务器只读取您有权访问的内容

许可证

麻省理工学院

相关 MCP