JinDaGe - Substack MCP Details

article

README

🚀 Substack MCP 服务器

本项目是一个为 Substack API 集成 Claude 和其他人工智能助手实现模型上下文协议 (MCP) 的服务器，可助力开发者利用 MCP 协议与 Substack 进行交互，实现新闻简报、帖子等内容的获取与搜索。

🚀 快速开始

此项目实现了支持与 Substack 新闻简报、帖子和作者交互的模型上下文协议 (MCP) 服务器。它利用了 Substack API 库，并通过 MCP 提供其功能。

借助此 MCP 服务器，Claude 可以：

获取新闻简报中的文章、播客和推荐内容
获取帖子的内容和元数据
在新闻简报中搜索帖子
获取用户个人资料信息和订阅

✨ 主要特性

支持与 Substack 新闻简报、帖子和作者交互。
利用 MCP 协议，Claude 可实现多种数据获取与搜索功能。

📦 安装指南

先决条件

Python 3.10 或更高版本
Claude 桌面版（用于测试）

设置

克隆此仓库：

git clone https://github.com/Greg-Swiftomatic/substack-mcp.git
cd substack-mcp

使用 uv 初始化虚拟环境：

curl -LsSf https://astral.sh/uv/install.sh | sh  # 如果尚未安装，请先安装 uv
uv init .
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

安装依赖项：
```
uv add "mcp[cli]" substack-api
```

💻 使用示例

运行服务器

运行 MCP 服务器：

python substack_mcp.py

配置 Claude 桌面版

打开 Claude 桌面版的配置文件：
- macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json

添加您的服务器配置：

{
    "mcpServers": {
        "substack": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/substack-mcp",
                "run",
                "substack_mcp.py"
            ]
        }
    }
}

重启 Claude 桌面版。

示例查询

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

“显示来自 https://stratechery.com/ 的近期文章”
“请展示这篇文章的内容：https://stratechery.com/2023/the-ai-unbundling/”
“在 https://stratechery.com/ 中搜索‘AI’”
“谁是 https://stratechery.com/ 的作者？”

📚 详细文档

可用工具

服务器提供了以下 MCP 工具： | 属性 | 详情 | |------|------| | 工具名称 | substack_mcp | | 详情 | 与 Substack API 集成的 MCP 服务器 |

项目结构

substack_mcp.py：主服务器文件
config.py：配置文件
requirements.txt：依赖项列表

开发

克隆仓库

git clone https://github.com/Greg-Swiftomatic/substack-mcp.git
cd substack-mcp

安装依赖项

pip install -r requirements.txt

运行测试

python test_substack_mcp.py

故障排除

查看日志

# macOS/Linux
tail -f logs/error.log

# Windows
type logs\error.log

检查配置文件 确保配置文件路径正确，并且语法无误。
重新启动服务器
```
python substack_mcp.py restart
```

📄 许可证

项目在 MIT License 下开源。

致谢

感谢以下项目和库的支持：

Substack