JinDaGe - substack-fetcher-mcp MCP Details

article

README

🚀 Substack 阅读器

Substack 阅读器是一个实用工具，专为从 Adam Mancini 的 Trade Companion 时事通讯获取和阅读文章而设计，能帮助用户便捷地获取所需资讯。

🚀 快速开始

在开始使用 Substack 阅读器之前，您需要完成安装和相关设置。下面将为您详细介绍具体步骤。

📦 安装指南

先决条件

Python 3.8 或更高版本
Python 的 uv 包管理器
Claude AI 助手

安装步骤

安装 uv 包管理器：若尚未安装 uv 包管理器，可使用以下命令进行安装：

curl -sSf https://install.ultraviolet.dev | sh

创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # Windows 用户请运行：.venv\Scripts\activate

安装依赖项：使用 pyproject.toml 文件安装依赖项：

uv pip install -e .

Substack 身份验证设置

若要访问订阅者专属内容，您需提供 Substack cookies，具体操作如下：

安装 Cookie-Editor 扩展：在浏览器中安装 Cookie-Editor 扩展，可通过以下链接进行安装：
- Chrome 网上应用商店
- Firefox 插件
登录 Substack 账户：登录到您的 Substack 账户 tradecompanion.substack.com
导出 cookies：点击 Cookie-Editor 扩展图标，然后点击 "导出" 并选择 "导出为 JSON"，这会将 cookie 复制到剪贴板。
创建并保存文件：在项目根目录中创建文件 substack_cookies.json，将复制的 cookie 粘贴到此文件中并保存。

🔧 与 Claude 配合使用

该工具专为与 Claude AI 助手一起使用而设计，设置步骤如下：

配置 Claude：在您的 Claude 配置文件中添加以下内容，以配置 Claude 使用此 MCP 服务器：

{
  "mcpServers": {
    "substack_reader": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/substack_reader",
        "run",
        "substack_reader.py"
      ]
    }
  },
  "globalShortcut": "Ctrl+Space"
}

请将 /path/to/substack_reader 替换为您实际的 substack_reader 目录路径。 2. 启动 Claude：配置完成后，启动 Claude 时会自动连接到此 MCP 服务器。 3. 检索文章：启动 Claude 后，您可以要求 Claude 检索最新的 Trade Companion 文章。

✨ 主要特性

获取最新文章：可获取 Adam Mancini 的最新 Trade Companion 文章。
提取纯文本内容：能将文章内容提取为纯文本格式。
保留文章结构：保留标题、段落和列表项，方便阅读。
排除特定文章：排除 "My Trade Methodology Fundamentals" 文章。

📄 隐私说明

您的 Substack cookies 存储在本地的 substack_cookies.json 文件中，仅用于验证请求到 Substack，不会以任何形式发送到其他地方或被泄露，请您放心使用。

substack-fetcher-mcp