使用说明

项目简介

该MCP Substack Server是一个专门为大型语言模型（LLM）客户端设计的后端服务，它实现了Model Context Protocol (MCP)，能够让LLM应用（如Claude.ai桌面应用）获取Substack平台上的文章内容。通过该服务器，LLM可以下载并解析Substack文章，提取文章标题、作者、副标题和正文等信息，从而扩展LLM的知识库和上下文理解能力。

主要功能点

Substack文章内容获取: 能够下载并解析公开Substack博客平台的文章内容。
信息提取: 从Substack文章中提取关键信息，包括标题、作者、副标题和文章正文。
Claude.ai 集成: 专门为Claude.ai桌面应用设计，通过MCP协议无缝集成。
作为 MCP 服务器运行: 遵循 MCP 协议规范，为 LLM 客户端提供标准化的上下文服务。

安装步骤

安装依赖: 确保你的系统已安装 Node.js v18 或更高版本和 npm。在项目根目录下，运行以下命令安装项目依赖：
```
npm install
```
启动服务器: 安装完成后，在项目根目录下，运行以下命令启动 MCP Substack Server：
```
npm start
```
服务器默认会在后台运行，等待客户端连接。

服务器配置

为了让 Claude.ai 桌面应用能够连接到 MCP Substack Server，你需要修改 Claude.ai 的配置文件 'claude_desktop_config.json'。请按照以下步骤配置：

找到 Claude.ai 桌面应用的配置文件 'claude_desktop_config.json'，该文件通常位于 '~/Library/Application Support/Claude/' 目录下。
打开 'claude_desktop_config.json' 文件，在 'mcpServers' 字段中添加一个新的服务器配置项 'mcp-substack'。配置信息如下（请根据你的实际安装路径调整）：

{
  "mcpServers": {
    "mcp-substack": {
      "command": "/opt/homebrew/bin/node",  // Node.js 的可执行文件路径，根据你的实际安装路径修改
      "args": ["/path/to/mcp-substack/lib/index.mjs"], // MCP Substack Server 的启动文件路径，请替换为你的实际路径
      "methods": {
        "download_substack": {  // 定义服务器提供的工具 (Tool)
          "description": "Download and parse content from a Substack post" // 工具的描述信息
        }
      }
    }
  }
}

配置信息说明:

'command': Node.js 运行环境的可执行文件路径。你需要根据你的Node.js安装位置进行调整。例如，如果你使用 nvm 管理 Node.js 版本，路径可能会有所不同。
'args': 一个字符串数组，包含了启动 MCP Substack Server 所需的参数。这里指定了服务器的入口文件 'lib/index.mjs' 的绝对路径。你需要将 '/path/to/mcp-substack' 替换为你实际的项目文件路径。
'methods': 定义了该 MCP 服务器提供的工具列表。 'download_substack' 是工具的名称，'description' 是对该工具的简要描述，用于在 LLM 客户端中展示。

保存 'claude_desktop_config.json' 文件。

基本使用方法

配置完成后，在 Claude.ai 桌面应用中，你可以通过自然语言指令来调用 MCP Substack Server 提供的功能。例如，你可以使用以下指令让 Claude.ai 下载并总结一篇 Substack 文章：

Could you download and summarize this Substack post: [Substack 文章的URL]

将 '[Substack 文章的URL]' 替换为你要分析的 Substack 文章的实际链接。Claude.ai 会识别 'download_substack' 工具，并调用 MCP Substack Server 获取文章内容，然后进行总结或其他操作。

注意: 请确保 Substack 文章是公开的，该服务器目前可能无法访问需要订阅或登录才能查看的文章。

关键词