Official Substack MCP Server

🚀 写作上下文工具为Claude

Claude连接到您的Substack和Medium写作的开放源代码模型上下文协议（MCP）实现。本工具能让Claude访问并分析您在Substack和Medium发表的文章，理解发布内容的上下文，为您提供更个性化的写作帮助。

🚀 快速开始

写作上下文工具是一个MCP服务器，它允许Claude访问并分析您从Substack和Medium发表的文章。借助该工具，Claude可以理解您发布内容的上下文，从而为您提供更贴合需求的写作辅助。

✨ 主要特性

• 🔍 从Substack和Medium检索并永久缓存您的文章
• 🔎 使用嵌入式技术找到与您的查询最相关的文章
• 📚 将单篇文章作为单独资源提供给Claude
• 🧠 在您的作品中执行语义搜索
• ⚡ 启动时预加载所有内容并生成嵌入

📦 安装指南

先决条件

• Python 3.10或更高版本
• 最新版本的Claude Desktop
• 具有已发布内容的Substack或Medium帐户

1.克隆此仓库

git clone https://github.com/yourusername/writer-context-tool.git
cd writer-context-tool

2.设置Python环境

使用uv（推荐）：

# 安装uv，如果您没有的话
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建虚拟环境并安装依赖项
uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
uv pip install -r requirements.txt

或使用标准pip：

python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
pip install -r requirements.txt

3.配置您的博客

1. 复制示例配置文件：

cp config.json.example config.json

2. 根据需要编辑config.json中的值，特别是content_refresh_interval和embedding_model_choice。

4.运行工具

启动写作上下文工具：

python run.py

💻 使用示例

基础用法

安装完成后，您将在Claude Desktop中看到个人文章作为资源。您可以执行以下操作：

1. 搜索您的作品：让Claude查找相关内容
   • "找到讨论[特定主题]的文章"
   • "关于[主题]我写了什么？"
2. 引用单篇论文：通过点击搜索结果中的文章访问完整的文本
   • "显示[文章标题]的全文"
3. 刷新内容：强制刷新所有内容
   • "刷新我的写作内容"

📚 详细文档

写作上下文工具提供以下可用工具和资源：

1. 单篇论文资源：每篇文章都成为可选资源
2. search_writing：一种语义搜索工具，使用嵌入找到最相关的文章
3. refresh_content：刷新并重新缓存所有配置平台上的内容

🔧 技术细节

工作原理

工具通过RSS feeds连接到您的Substack/Medium博客，获取文章并本地永久缓存。同时为每篇文章生成嵌入式，实现基于查询的语义搜索以找到最相关的文章。当您询问Claude关于您的写作时，它可以使用这些单篇论文资源为您提供见解或帮助您根据现有内容开发新想法。

缓存工作原理

工具实现永久缓存，具有以下功能：

1. 磁盘缓存：所有内容都存储在磁盘上，因此在会话之间持久存在
2. 嵌入式：每篇文章转换为嵌入以进行语义搜索
3. 选择性刷新：工具根据您的缓存设置仅刷新所需内容
4. 预加载：启动时自动刷新所有内容并生成嵌入

📄 许可证

此项目在MIT License下可用。

常见问题

如果您遇到问题：

1. 工具未显示在Claude Desktop中：
   • 检查您的Claude Desktop配置文件是否正确
   • 确保配置中的所有路径都是绝对路径
   • 确保Python环境安装了所有必需的包
   • 重新启动Claude Desktop
2. 没有内容显示：
   • 验证config.json中的Substack/Medium URL
   • 尝试使用"refresh_content"工具
   • 检查您的博客是否公开且有已发布文章
3. uv命令错误：
   • 尝试使用shell脚本方法
   • 确认uv命令已安装并在PATH中
4. 嵌入式问题：
   • 如果看到有关嵌入式模型的错误，请确保有足够的磁盘空间
   • 考虑重新运行以获得更好的效果如果嵌入式未正确工作