LOFTER Admin MCP Server

将 LOFTER 管理后台的核心能力封装为 AI 可直接调用的工具集，让 AI 能够查询文章、创作者、IP、标签等内容数据，辅助运营决策和内容分析。

快速接入

环境要求

• Node.js >= 20

stdio 模式（本地集成）

在 .mcp.json 的 mcp 字段中添加：

"LOFTER-admin": {
  "type": "stdio",
  "command": "pnpx",
  "args": ["@lofter-admin/mcp-backend", "start", "-t", "stdio"],
  "enabled": true,
  "timeout": 60000
}

LOFTER_ADMIN_SECRET 为 LOFTER 管理后台鉴权密钥，向管理员申请。

也可通过 lofter-admin-cli 写入本地配置，无需在 MCP 配置中重复填写：

lofter-admin-cli config --set secret=<你的密钥>

写入后保存在 ~/.lofter-micro/config，mcp-backend 会自动读取。

HTTP 模式（远程服务 / 多用户）

启动 HTTP MCP Server（可选配默认密钥作为 fallback）：

LOFTER_ADMIN_SECRET=<默认密钥> npx @lofter-admin/mcp-backend start -t http -p 3000

Secret 优先级：请求 header > 环境变量 LOFTER_ADMIN_SECRET > lofter-admin-cli config --set secret=xxx 写入的本地配置（~/.lofter-micro/config）。多用户并发场景下，每个请求独立使用自己的 secret，互不干扰。未提供 header 时依次 fallback 到环境变量和本地配置；三者均未设置则返回错误。

技术信息

• 包名：@lofter-admin/mcp-backend
• 协议：MCP（Model Context Protocol）
• 传输模式：stdio（本地集成）/ HTTP SSE（远程集成）
• 上游服务：https://lofter.hz.netease.com
• 认证方式：Header lofter-micro-secret；HTTP 模式支持通过请求 header LOFTER_ADMIN_SECRET 动态传入；也可通过 lofter-admin-cli config --set secret=xxx 写入本地配置