MCP 服务器

Hexo Blog MCP Server

Enables AI clients to manage Hexo blogs by providing tools for article CRUD operations, local previewing, and GitHub Pages deployment. It also supports site configuration access and automated Git backups to streamline the entire blogging workflow.

README

🚀 Hexo Blog MCP Server

一个基于 Model Context Protocol 的 Hexo 博客管理服务器，让 AI 客户端（Claude Desktop、Cursor 等）能够直接管理你的 Hexo 博客。

✨ 功能特性

📝 文章管理 — 列出、搜索、读取、创建、编辑、删除博客文章
👀 本地预览 — 一键启动/停止 Hexo 本地预览服务器
🌐 一键发布 — 构建并部署到 GitHub Pages
💾 源码备份 — 自动 Git 提交并推送到 hexo-source 分支
🔒 安全防护 — 路径沙盒、分支锁定、命令超时保护

📦 安装

# 克隆或进入项目目录
cd /Users/lizexi/Documents/AI/aiMcp/hexo-mcp-server

# 安装依赖
npm install

# 构建
npm run build

⚙️ MCP 客户端配置

在你的 AI 客户端中添加以下 MCP 配置：

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "hexo-blog": {
      "command": "node",
      "args": ["/Users/lizexi/Documents/AI/aiMcp/hexo-mcp-server/dist/index.js"],
      "env": {
        "BLOG_ROOT": "/Users/lizexi/Documents/code/leejersey.github.io"
      }
    }
  }
}

Cursor

在 Cursor Settings → MCP 中添加相同配置。

🛠️ 可用的 Tools

文章管理

工具	参数	功能
`list_posts`	`keyword?`	列出所有文章，支持按关键词过滤标题和标签
`search_posts`	`query`	按关键词全文搜索文章（标题+正文）
`read_post`	`filename`	读取指定文章的完整内容（含 Front-matter）
`create_post`	`title`, `content?`, `tags?`	创建新文章并自动生成 Front-matter
`update_post`	`filename`, `content`, `title?`, `tags?`	修改文章内容或元数据
`delete_post`	`filename`	删除指定文章

博客操作

工具	功能
`preview_blog`	执行 `hexo clean && hexo g && hexo s`，启动本地预览（localhost:4000）
`stop_preview`	停止正在运行的预览服务器
`deploy_blog`	执行 `hexo clean && hexo g && hexo d`，发布到 GitHub Pages

Git 操作

工具	参数	功能
`backup_source`	`message?`	Git add → commit → push 到 `hexo-source` 分支
`quick_publish`	`message?`	一键完成 deploy + backup 组合操作
`git_status`	—	查看当前工作区的 Git 状态

📚 可用的 Resources

URI	描述
`blog://config/site`	站点配置 `_config.yml` 的内容
`blog://config/theme`	Apollo 主题配置 `_config.apollo.yml` 的内容
`blog://posts/summary`	所有文章的元数据汇总（标题、日期、标签、字数）

🏗️ 项目结构

src/
├── index.ts              # MCP 服务器入口
├── config.ts             # 路径与常量配置
├── tools/
│   ├── post-tools.ts     # 文章管理工具（6个）
│   ├── hexo-tools.ts     # 构建/预览/部署工具（3个）
│   └── git-tools.ts      # Git 操作工具（3个）
├── resources/
│   └── blog-resources.ts # 博客数据资源（3个）
└── utils/
    ├── post-manager.ts   # 文章文件操作核心逻辑
    ├── hexo-runner.ts    # shell/hexo 命令封装
    └── git-runner.ts     # git 命令封装