Name: AI新闻简报摘要服务
Author: alialfredji

使用说明

超人通讯mcp

一个MCP（模型上下文协议）服务器，从两份人工智能通讯中获取完整的帖子内容-- 超人AI 和代码 --并将其返回给克劳德进行每周摘要生成。

不需要API密钥。没有浏览器自动化。只需简单的HTTP抓取两份公开的Beehiiv通讯。

工具

`fetch_superhuman_newsletters`

从以下位置获取最近的帖子 超人AI （超人.ai）。

参数	类型	默认值	范围	描述
`count`	编号	`7`	1–30	要获取的最近帖子数

返回一个单独的markdown文档，其中包含每个帖子的完整内容：标题、日期、作者、源URL、正文、图像和所有外部链接。

`fetch_code_newsletter`

从以下位置获取最近的帖子代码（codenewspaper.ai）。

参数	类型	默认值	范围	描述
`count`	编号	`5`	1–9	要获取的最近帖子数量（存档最多9个）

输出格式与上述相同。

与Claude一起使用

选项A——本地（stdio）

直接连接到Claude Desktop或任何支持stdio的MCP客户端。

安装和构建：

git clone https://github.com/alialfredji/superhuman-newsletter-mcp.git
cd superhuman-newsletter-mcp
npm install
npm run build

配置Claude桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "superhuman-newsletter": {
      "command": "node",
      "args": ["/absolute/path/to/superhuman-newsletter-mcp/dist/index.js"]
    }
  }
}

保存后重新启动Claude Desktop。

选项B——远程（HTTP）

使用托管实例（部署到Render后）——无需本地安装。

配置克劳德桌面或OpenCode：

{
  "mcpServers": {
    "superhuman-newsletter": {
      "url": "https://superhuman-newsletter-mcp.onrender.com/mcp"
    }
  }
}

选项C--npx（不安装）

直接运行，无需克隆或安装任何东西。npm按需下载并运行最新版本。

配置Claude桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "superhuman-newsletter": {
      "command": "npx",
      "args": ["superhuman-newsletter-mcp"]
    }
  }
}

保存后重新启动Claude Desktop。

问克劳德什么

连接后（任一模式）：

“获取最后7份超人通讯，给我写一份每周摘要”

“从the Code时事通讯中获取最后5篇帖子，并总结关键的开发人员故事和工具”

“拉两份时事通讯，给我一份每周AI+开发摘要，并附上必读链接”

Claude直接收到完整的帖子内容——无需打开网址，也无需额外步骤。

部署以渲染

回购附带 render.yaml 和 Dockerfile --除了连接您的GitHub帐户外，不需要任何配置。

第一步——推送到GitHub

确保你的仓库已推送到GitHub（它已经在 github.com/alialfredji/superhuman-newsletter-mcp).渲染将从那里开始。

步骤2--创建渲染帐户

首选 render.com 并注册或登录。免费计划就足够了。

第三步——连接GitHub

在“渲染”仪表板中，单击您的头像（右上角）→ 账户设置 → 关联账户 → 连接GitHub。授予访问权限 superhuman-newsletter-mcp 回购（或所有回购）。

步骤4——通过蓝图部署

在“渲染”仪表板中，单击新 → 蓝图
查找并选择 superhuman-newsletter-mcp 仓库
渲染读取 render.yaml 自动-您将看到一个名为 superhuman-newsletter-mcp 上市
点击应用 --Render开始构建Docker镜像

第一个构建需要大约2-3分钟（安装deps+编译TypeScript）。后续部署在每个 git push 大约需要1分钟。

步骤5--确认服务已上线

构建完成后，Render会指定一个URL，如下所示：

https://superhuman-newsletter-mcp.onrender.com

验证它是否正在运行：

curl https://superhuman-newsletter-mcp.onrender.com/health
# → {"status":"ok"}

注：免费套餐服务在15分钟不活动后就会停止运行。睡眠后的第一个请求需要大约30秒才能醒来。付费计划(starter 及以上）始终保持开启状态。

步骤6--将Claude连接到远程服务器

将部署的URL添加到您的Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "superhuman-newsletter": {
      "url": "https://superhuman-newsletter-mcp.onrender.com/mcp"
    }
  }
}

重新启动Claude Desktop——这些工具现在可以通过云从任何机器上使用。

部署什么

端点	方法	描述
`/mcp`	`POST` / `GET` / `DELETE`	MCP可流式HTTP传输
`/health`	`GET`	退货 `{"status":"ok"}` 用于渲染健康检查

更新部署

每 git push 到 main 在Render上触发自动重新部署，无需手动步骤。

发展

# Install dependencies
npm install

# Run in dev mode — stdio (no build step)
npm run dev

# Run in dev mode — HTTP on port 3000
npm run dev:http

# Build
npm run build

# Run built server — stdio
npm start

# Run built server — HTTP
npm run start:http

HTTP模式在以下情况下自动激活 PORT 设置环境变量（与Render一样），或者当 --http 旗帜被传递了。

项目结构

src/
  index.ts        # All logic — scrapers, MCP tools, transport modes
Dockerfile        # Docker build for Render
render.yaml       # Render deployment config
tsconfig.json     # TypeScript config

运作原理

收到工具调用 --克劳德请求N个帖子
列表抓取 --获取时事通讯主页/存档以收集帖子URL
后刮 --访问每个URL，去除噪声（导航、广告、赞助商块），转换HTML→ 通过调低Markdown
JSON-LD提取 --从每篇帖子中提取结构化元数据（标题、日期、作者、描述、特色图片）
返回 --单一格式的降价文档交还给克劳德

赞助商/广告部门(PRESENTED BY, SPONSORED BY)自动剥离。在帖子获取之间增加了300毫秒的礼貌延迟。

技术栈

@modelcontextprotocol/sdk --MCP服务器+流式HTTP传输
express --用于远程模式的HTTP服务器
node-html-parser --HTML解析
turndown --HTML→ Markdown转换
zod --输入模式验证

使用说明

超人通讯mcp

工具

fetch_superhuman_newsletters

fetch_code_newsletter