Substack Mcp

搜索官方认证 Python

🚀 Substack MCP 服务器

本项目实现了一个支持 Model Context Protocol (MCP) 的服务器，可将 Substack API 集成到 Claude 等 AI 助手中，让 AI 助手能通过统一接口与 Substack 的时事通讯、文章和作者进行交互，极大地拓展了 AI 助手的信息获取范围。

🚀 快速开始

此项目实现了 Model Context Protocol (MCP) 服务器，让 AI 助手（如 Claude）能通过统一接口与 Substack 时事通讯、文章和作者交互。借助该服务器，Claude 可获取时事通讯文章、播客、推荐、文章内容和元数据，还能在时事通讯中搜索文章，获取用户个人资料信息和订阅。

✨ 主要特性

统一交互接口：借助 MCP 服务器，AI 助手如 Claude 能通过统一接口与 Substack 时事通讯、文章和作者交互。
丰富信息获取：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 提问如下问题：

获取具体时事通讯的文章列表
查看某文章的详细信息和内容
搜索特定主题或关键词
列出用户的所有订阅
获取某订阅的最新更新

📚 详细文档

项目结构

substack-mcp/
├── README.md          # 项目文档
├── substack_mcp.py    # 主 MCP 服务器实现
└── requirements.txt   # 依赖项清单

🔧 技术细节

此项目基于 Substack API 库，并通过 MCP 提供其功能。它实现了一个 MCP 服务器，使 AI 助手如 Claude 能够通过统一接口与 Substack 时事通讯、文章和作者交互。

📄 许可证

文档未提及许可证相关信息。

⚠️ 重要提示

所有 API 请求都需要有效的认证令牌。

确保服务器在安全的网络环境中运行。

定期更新 API 令牌以增强安全性。

通过以上步骤，你可以轻松地将 Substack 内容集成到任何支持 MCP 协议的 AI 助手中，扩展其功能和应用场景。

0 条评论
分类：搜索