Substack Reader MCP Server

子组读取器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定期过期-身份验证失败时重新导出
• 服务器只读取您有权访问的内容

许可证

麻省理工学院