Halo MCP 多版本盘点：Python 与 Node.js 怎么选？

文档更新：2026-05-29
前置阅读：Halo 博客 MCP 接入与连接测试（Cursor）

最近在 Cursor 里接入了 Halo 博客 MCP，写了几篇 MCP 相关的文章。顺手调研了一下：叫 "Halo MCP" 的项目不止一个，技术栈、目标产品也各不相同。这篇做个汇总，方便以后选型。

什么是 Halo MCP？

Halo 是一款开源博客/CMS 系统。MCP（Model Context Protocol）则让 AI 助手（Cursor、Claude Desktop 等）能通过标准协议调用外部工具。

Halo MCP 就是把两者连起来：在对话里直接管理博客——发文章、改分类、传附件，不用手动登录后台。

用户 / AI 对话
    ↓
MCP Client（Cursor / Claude Desktop）
    ↓ stdio
Halo MCP Server（Python 或 Node.js）
    ↓ REST API + PAT Token
Halo 博客站点

一、Python 版：halo-mcp-server（主流选择）

这是目前最成熟、功能最全的 Halo 博客 MCP，也是我在 Cursor 里正在用的版本。

核心能力

• 30+ Tools：文章、分类、标签、附件的增删改查与发布
• 10 个 AI Prompts：博客写作、SEO 优化、标题生成、摘要生成、标签/分类建议、内容翻译与校对、系列文章规划等
• 支持 Markdown / HTML 内容格式

Cursor 配置示例

{
  "mcpServers": {
    "halo": {
      "command": "/opt/anaconda3/bin/python3.12",
      "args": ["-m", "halo_mcp_server"],
      "env": {
        "HALO_BASE_URL": "https://your-halo-site.com",
        "HALO_TOKEN": "pat_xxx"
      }
    }
  }
}

安装

pip install halo-mcp-server

适合：想要开箱即用、重视 AI 写作辅助、已有 Python 环境的用户。

二、Node.js 版：halo-mcp（新兴替代）

npm 上有一个专门针对 Halo 博客的 Node.js MCP，名字容易和 Python 版混淆，但是独立项目。

与 Python 版的差异

Node.js 版在管理面工具更多，但没有内置 AI 写作 Prompts。

Cursor 配置示例

{
  "mcpServers": {
    "halo": {
      "command": "npx",
      "args": ["-y", "halo-mcp"],
      "env": {
        "HALO_BASE_URL": "https://your-halo-site.com",
        "HALO_API_TOKEN": "pat_xxx"
      }
    }
  }
}

适合：Node 技术栈为主、需要评论/单页/菜单等 Python 版没有的能力、愿意尝鲜的用户。

三、别搞混：其他叫 "Halo" 的 MCP

搜索 "halo mcp" 时会冒出不少同名项目，它们和 halo.run 博客无关：

选的时候看清楚 README 里的目标产品，别装错了。

四、怎么选？

继续用 Python 版，如果：

• 已经在用 halo-mcp-server，配置稳定
• 需要 AI 写作 Prompts（标题、SEO、摘要等）
• 日常操作以文章/分类/标签/附件为主

试试 Node.js 版，如果：

• 想统一 Node 生态（和 telegraph-image-mcp 等放一起）
• 需要评论管理、单页、菜单、站点统计等扩展能力
• 能接受较新项目可能的不稳定

我的现状

目前 Cursor 里接的是 Python 版 halo-mcp-server v0.2.0，站点 halo.gwozai.com，30 个 Tools + 10 个 Prompts 日常够用。这篇博客本身就是通过 Halo MCP 创建并发布的。

五、获取 API Token

两个版本都需要 Halo 后台的 Personal Access Token：

1. 登录 Halo 控制台
2. 进入 用户中心 → Personal Access Tokens
3. 创建新 Token，赋予内容管理权限
4. 写入 MCP 配置的环境变量

Python 版用 HALO_TOKEN，Node.js 版用 HALO_API_TOKEN，注意区分。

参考链接

• halo-mcp-server（Python）
• halo-mcp（Node.js）
• Halo 官网
• MCP 协议

本文由 Cursor + Halo MCP（Python 版）自动撰写并发布。