Monolith MCP

Monolith 博客专属 MCP 服务器

42 个工具 · 全权管理文章 / 评论 / 媒体 / 设置 / 备份 / 导入 / 分析

快速开始

1. 配置 MCP 客户端

在你的 AI 编辑器（如 Cursor、Windsurf、Antigravity 等）的 MCP 配置中添加：

{
  "mcpServers": {
    "monolith": {
      "command": "npx",
      "args": ["-y", "monolith-mcp"],
      "env": {
        "MONOLITH_API_URL": "https://your-blog-api.workers.dev",
        "MONOLITH_PASSWORD": "your_admin_password"
      }
    }
  }
}

2. 环境变量

| 变量 | 必填 | 说明 | |------|------|------| | MONOLITH_API_URL | ✅ | Monolith 后端 API 地址 | | MONOLITH_PASSWORD | ✅ | 管理员密码 |

工具清单

| 模块 | 工具 | 数量 | |------|------|:----:| | 📝 文章 | list_posts · get_post · create_post · update_post · delete_post · batch_posts · search_posts · list_post_versions · restore_post_version | 9 | | 💬 评论 | list_comments · approve_comment · delete_comment | 3 | | 🖼️ 媒体 | list_media · upload_media · delete_media · localize_post_images · localize_all_images | 5 | | 📊 统计 | get_dashboard_stats · get_analytics · get_ae_analytics · get_traffic | 4 | | ⚙️ 设置 | get_settings · update_settings | 2 | | 📄 页面 | list_pages · get_page · upsert_page · delete_page | 4 | | 🏷️ 分类 | list_tags · list_categories · get_series | 3 | | 💾 备份 | export_backup · backup_to_r2 · backup_to_webdav · test_webdav_backup · list_r2_backups · preview_backup · preview_r2_backup · delete_r2_backup · restore_backup · restore_r2_backup | 10 | | 📦 导入 | preview_halo_import · import_halo_data | 2 |

⚠️ 标记为【高危操作】的工具（delete_*、batch_posts 删除、restore_*、import_halo_data 的 overwrite 模式）执行前会要求 confirm: "yes"。

与当前 Monolith 后台能力对应

• 文章字段使用当前 API 契约：published / listed / coverColor / coverImage / publishAt / seriesSlug / seriesOrder / category。
• create_post 默认创建草稿；如需立即发布，请显式传入 published: true。
• batch_posts 支持 publish、draft、delete；其中 draft 会转换为后端实际动作 unpublish。
• 统计支持普通 D1/Turso/PG 访问分析，也支持 Cloudflare Analytics Engine 增强分析：get_ae_analytics。
• 备份支持 JSON 导出、R2 快照、R2 预览/恢复/删除、WebDAV 备份与连通性测试。
• 媒体支持 R2/S3 列表、上传、删除，并可将文章中的 HTTPS 外链图片本地化。
• 导入支持 Halo 1.x / 2.x JSON 预览与导入。

本地开发

git clone https://github.com/one-ea/Monolith-MCP.git
cd Monolith-MCP
npm install
npm run build
npm run smoke
node dist/index.js

License

MIT