🚀 Substack MCP 服务器
Substack MCP 服务器是一个模型上下文协议（MCP）服务器，它让Claude和其他人工智能助手能够与Substack新闻通讯、文章以及用户资料进行交互，为AI使用Substack数据提供了便捷途径。
🚀 快速开始
该项目把Substack API 库转换成了Anthropic的MCP服务器，让Claude可以实现以下功能：
- 获取新闻通讯文章、播客和推荐内容
- 获取用户个人资料信息和订阅详情
- 获取文章内容和元数据
- 搜索特定新闻通讯中的文章
- 跨多个Substack新闻通讯同时搜索
- 按类别发现热门的Substack新闻通讯
✨ 主要特性
- 支持Claude与Substack的多种数据交互，如文章、用户资料等。
- 提供跨多个新闻通讯的搜索功能以及按类别发现热门通讯的能力。
📦 安装指南
先决条件
- Python 3.10或更高版本
- Claude桌面版（用于测试时）
安装步骤
# 克隆仓库
git clone https://github.com/Greg-Swiftomatic/substack-mcp-server.git
cd substack-mcp-server
# 设置虚拟环境
python -m venv venv
source venv/bin/activate # Windows：venv\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
或者使用uv：
# 使用uv进行更快的安装
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
💻 使用示例
运行服务器
python substack_mcp.py
与Claude桌面版连接
- 打开你的Claude桌面版配置文件：
# MacOS open ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\mcp*.log - 添加以下内容到
claude-config.json：{ "context_providers": { "substack_mcp": { "type": "custom", "class": "SubstackMCPProvider", "args": { "server_url": "http://localhost:1234" } } } }
工具使用示例
基础用法
获取新闻通讯文章 (get_newsletter_posts)
- 参数：
newsletter_id（必需） - 返回值：包含文章列表和元数据的字典
- 示例响应：
{ "posts": [ { "id": "123", "title": "最新科技动态", "content": "探索未来科技趋势..." } ], "metadata": { "total_count": 10, "page": 1 } }
获取用户资料 (get_user_profile)
- 参数：无
- 返回值：包含用户详细信息的字典
- 示例响应：
{ "user_id": "456", "username": "tech_guru", "subscriber_count": 10000 }
搜索文章 (search_posts)
- 参数：
query（必需），newsletter_id（可选） - 返回值：包含搜索结果的列表和元数据
- 示例响应：
{ "results": [ { "id": "789", "title": "AI的未来", "contentSnippet": "...人工智能的应用与发展..." } ], "metadata": { "total_count": 20, "page": 1 } }
📚 详细文档
开发和贡献
创建功能分支
# 克隆仓库
git clone https://github.com/Greg-Swiftomatic/substack-mcp-server.git
# 创建新功能分支
git checkout -b feature/amazing-feature
# 提交更改
git commit -m '添加了令人惊叹的功能'
# 推送到远程仓库
git push origin feature/amazing-feature
📄 许可证
本项目根据MIT License授权，具体内容请参阅LICENSE文件。
致谢
- NHagar/substack_api——原始的Substack API库
- 模型上下文协议——Anthropic的MCP规范