超人通讯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:httpHTTP模式在以下情况下自动激活 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服务器- --HTML解析
turndown--HTML→ Markdown转换zod--输入模式验证