mcp-blog MCP 服务说明文档
1. 服务概述
一句话简介：博客管理API的MCP服务器，提供通过Claude Code预览、发布、列出和删除博客文章的工具。
- 服务名称：mcp-blog
- 版本号：1.0.0
- 开发者/提供方：MasatoshiSano
- 协议类型：MCP (Model Context Protocol)
2. 核心功能
该MCP服务提供以下主要功能：
- 博客文章预览：AI辅助的frontmatter补全和正文结构修正，返回修正后的markdown、差异对比和Unsplash图片建议
- 博客文章发布：将修正后的markdown保存到S3并触发GitHub Actions重建
- 博客文章列表：列出文章，支持已发布过滤和数量限制
- 博客文章删除：通过slug删除文章并触发重建
3. 使用场景
该服务适合在以下情况下使用：
- 通过Claude Code管理博客内容
- 需要AI辅助优化博客文章结构
- 自动化博客发布流程
- 批量管理博客文章
4. 接入方式
4.1 服务端点
该服务通过stdio传输方式运行，需要配置BLOG_API_ENDPOINT环境变量指向博客API的基础URL。
4.2 认证与权限
需要配置BLOG_API_KEY环境变量进行HMAC认证。
4.3 数据格式
服务使用Markdown格式处理博客文章内容，支持frontmatter元数据。
4.4 服务器配置
在MCP客户端配置中添加服务：
{ "mcpServers": { "blog": { "command": "node", "args": ["/absolute/path/to/mcp-blog/dist/index.js"], "env": { "BLOG_API_ENDPOINT": "https://dxbqlfvrescw1.cloudfront.net/api", "BLOG_API_KEY": "<your-api-key>" } } } }5. 接口定义
| 工具名称 | 描述 | 参数 |
|---|---|---|
blog_preview_post | AI辅助的frontmatter补全和正文结构修正 | markdown内容 |
blog_publish_post | 保存修正后的markdown到S3并触发GitHub Actions重建 | markdown内容 |
blog_list_posts | 列出文章 | published（可选）, limit（可选） |
blog_delete_post | 通过slug删除文章并触发重建 | slug |
6. 快速开始
6.1 环境要求
- Node.js运行环境
- 有效的BLOG_API_ENDPOINT和BLOG_API_KEY
6.2 构建步骤
npm install npm run build7. 注意事项
- 确保配置正确的BLOG_API_ENDPOINT和API密钥
- 发布和删除操作会触发GitHub Actions重建
- 预览功能会建议Unsplash图片以增强视觉内容
- 服务通过stdio传输方式运行