blogcast MCP

BlogCast MCP

一篇帖子。每个平台。由Notion+Claude提供技术支持。

BlogCast MCP是一个开源的模型上下文协议服务器，它将Notion变成了一个无头CMS和发布中心。在仪表板或Notion中编写一次，然后使用Claude（或仪表板）同时发布到Dev.to、Hashnode、Medium等。

______________________________________________________________________

里面有什么

______________________________________________________________________

快速启动

先决条件

• Node.js 20+，npm 10+
• 具有API访问权限的Notion帐户
• Claude Desktop（用于MCP工具）——如果您只使用仪表板，则可选

1.克隆并安装

git clone https://github.com/thecodedaniel/blogcast-mcp.git
cd blogcast
npm install

2.运行一切

npm run dev          # starts server (3001) + client (5173)

或者单独运行：

npm run dev:server   # Express backend only
npm run dev:client   # React dashboard only
npm run dev:mcp      # MCP server only (for testing)

3.打开仪表板

导航至 http://localhost:5173 --设置页面将指导您完成以下操作：

1. 概念整合 -API密钥+数据库ID
2. 平台凭据 -Dev.to、Hashnode、Medium API密钥
3. AI功能 -Anthropic API密钥（可选，解锁智能发布前检查）
4. 克劳德桌面 --一键自动配置（无需手动JSON编辑）

第一轮： 添加Notion凭据后，BlogCast会自动设置所有必需的数据库列（幂等——可以随时重新运行）。

4.设置理念

1. 首选 notion.so/my集成 并创建新的集成
2. 在Notion中创建两个数据库： BlogCast帖子 和 BlogCast分析
3. 与集成共享两个数据库（打开每个数据库→ ⋯ → 连接→ 添加您的集成）
4. 从页面URL复制数据库ID（最后一个URL后的32个字符字符串 /)
5. 在中添加两个ID localhost:5173/settings

BlogCast将在第一次运行时自动将所有必需的列添加到两个数据库中。

5.构建MCP服务器（用于Claude Desktop）

npm run build:mcp

然后在“设置”中，单击 “连接克劳德桌面” --BlogCast将自动配置 claude_desktop_config.json 为你。

或手动添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "blogcast": {
      "command": "node",
      "args": ["/absolute/path/to/blogcast/mcp/dist/index.js"],
      "env": {
        "BACKEND_URL": "http://localhost:3001"
      }
    }
  }
}

______________________________________________________________________

写作文章

选项A——在仪表板中（推荐）

1. 点击 写 在侧边栏中
2. 使用富格文本编辑器键入标题并撰写帖子

- 完整工具栏：粗体、斜体、标题、内联代码、， 带有语法高亮显示的代码块 （TypeScript、Python、Dart、Go、Rust和20多种语言） - 生活 预览 模式切换

1. 在右侧边栏中添加标签、摘录并选择目标平台
2. 点击 保存草稿 （保存到Notion）或 保存并发布 （立即保存+发布）

选项B——直接知情

1. 打开你的 BlogCast帖子 Notion中的数据库
2. 点击 新 并在页面内写下你的帖子内容
3. 填写属性：标题、标签、发布到、摘录
4. 将状态设置为 *草稿* --它会自动出现在仪表板上

______________________________________________________________________

出版

通过仪表板

1. 写→ 保存并发布 --一步完成编写和发布
2. 帖子 → 点击任何帖子→ 重定向到 发布 page → 选择平台→ 单击“发布”

通过克劳德（MCP）

"Show me my draft posts"
"Preview my latest Notion draft"
"Publish my post about TypeScript to Dev.to and Hashnode"
"What's the status of my last post?"
"Schedule my React post for tomorrow at 9am UTC on all platforms"
"Add my Hashnode API key"
"Sync analytics for my last 5 posts"

______________________________________________________________________

MCP工具

______________________________________________________________________

AI功能

配置Anthropic API密钥时(Settings → AI Features):

AI功能是完全可选的，并且可以优雅地降级——发布通常不需要Anthropic密钥。

______________________________________________________________________

建筑

Notion Workspace (CMS + Analytics DB)
        │ Notion API
        ▼
BlogCast MCP Server (stdio, Claude integration)
        │ HTTP
        ▼
Express Backend (localhost:3001)
  ├── Publishers: Dev.to, Hashnode, Medium (draft)
  ├── AI service (Anthropic SDK — pre-publish checks, content adaptation)
  ├── Image service (download → cache → re-upload)
  ├── Format service (Markdown ↔ HTML)
  ├── Auth vault (encrypted local credentials)
  ├── Setup service (Notion DB auto-migration on startup)
  └── Scheduler (auto-publish at scheduled time)
        │
        ▼
Local Storage (./storage/)
  ├── images/   — cached images with deduplication
  ├── queue/    — pending publish jobs
  └── logs/     — winston logs

React Dashboard (localhost:5173)
  ├── Write     — TipTap rich text editor with syntax-highlighted code blocks
  ├── Posts     — list, search, filter all posts from Notion
  ├── Publish   — select post + platforms + AI pre-publish check
  ├── Platforms — add/remove/test API keys
  └── Settings  — Notion config, AI config, Claude Desktop auto-connect

______________________________________________________________________

图像处理

Notion CDN URL将在约1小时后过期。BlogCast透明地处理了这一点：

1. 图像从Notion下载并缓存在本地 storage/images/
2. 每个图像都通过URL（SHA-256）进行哈希运算以进行重复数据删除
3. 发布时，图像会上传到每个平台的CDN
4. 平台CDN URL已缓存，因此重新发布不会重新上传

______________________________________________________________________

概念数据库架构

帖子数据库(BlogCast Posts)

分析数据库(BlogCast Analytics)

当您首次配置Notion凭据时，所有列都会自动创建。无需手动设置数据库。

______________________________________________________________________

环境变量

几乎什么都不需要进去 .env。所有凭据和设置都是通过配置的 设置页面 (localhost:5173/settings)并加密存储在您的本地计算机上。

唯一可选的环境变量是：

看 .env.example 对于模板。

______________________________________________________________________

支持的平台

______________________________________________________________________

许可证

麻省理工学院——用❤️ 通过 科迪尼尔有限公司