Substack MCP

一个用于将Substack API与Claude及其他AI助手集成的MCP（Model Context Protocol）服务器。

概述

本项目实现了一个模型上下文协议（MCP）服务器，使像Claude这样的AI助手能够通过标准化接口与Substack的通讯、帖子和作者进行交互。它利用了Substack API库，并通过MCP提供其功能。

借助这个MCP服务器，Claude可以：

• 获取通讯文章、播客和推荐
• 获取文章内容和元数据
• 在通讯中搜索文章
• 获取用户资料信息和订阅

安装

前提条件

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

设置

1. 克隆此仓库：
   bash
   git clone https://github.com/Greg-Swiftomatic/substack-mcp.git
   cd substack-mcp

2. 使用uv设置虚拟环境：
   bash
   curl -LsSf https://astral.sh/uv/install.sh | sh # 如果尚未安装，则安装uv
   uv init .
   uv venv
   source .venv/bin/activate # 在Windows上: .venvScriptsactivate

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

使用

运行服务器

运行MCP服务器：

bash
python substack_mcp.py

配置桌面版Claude

1. 打开桌面版Claude的配置文件：

   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%Claudeclaude_desktop_config.json

2. 添加您的服务器配置：
   json
   {
   "mcpServers": {
   "substack": {
   "command": "uv",
   "args": [
   "--directory",
   "/ABSOLUTE/PATH/TO/substack-mcp",
   "run",
   "substack_mcp.py"
   ]
   }
   }
   }

3. 重启桌面版Claude。

示例查询

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

• "显示来自https://stratechery.com/的最新帖子"
• "这篇帖子的内容是什么：https://stratechery.com/2023/the-ai-unbundling/"
• "在https://stratechery.com/上搜索'AI'"
• "https://stratechery.com/的作者是谁？"

可用工具

服务器提供了以下MCP工具：

项目结构

• substack_mcp.py - 主MCP服务器实现
• examples/ - 示例查询和响应
• docker/ - 用于容器化部署的Docker配置

开发

要为该项目贡献代码：

1. 分叉仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

故障排除

如果您遇到问题：

1. 检查Claude的日志以查找错误：
   bash

   macOS/Linux

   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

   Windows

   type %APPDATA%ClaudeLogsmcp*.log

2. 确认您的服务器构建并运行时没有错误：
   bash
   python substack_mcp.py

3. 确保您的claude_desktop_config.json文件具有正确的路径和语法。

4. 尝试完全重启桌面版Claude。

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

致谢- Substack API - 用于 Substack 交互的基础库

• Model Context Protocol - Anthropic 的标准化大语言模型集成协议