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. 接口定义

6. 快速开始

6.1 环境要求

• Node.js运行环境
• 有效的BLOG_API_ENDPOINT和BLOG_API_KEY

6.2 构建步骤

npm install npm run build

7. 注意事项

• 确保配置正确的BLOG_API_ENDPOINT和API密钥
• 发布和删除操作会触发GitHub Actions重建
• 预览功能会建议Unsplash图片以增强视觉内容
• 服务通过stdio传输方式运行