# @bettercms-ai/mcp 中文文档

规范地址：https://npmcn.com/package/%40bettercms-ai/mcp/

版本：0\.95\.0
npm 元数据更新时间：2026-11-05T14:14:27.937Z
中文译文更新时间：2026-11-08T00:15:14.404Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bettercms-ai/mcp
原文对照：https://npmcn.com/package/%40bettercms-ai/mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.5 MB，42 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-06-30T11:08:02.920Z
- 最新版本发布：2026-11-05T14:14:27.690Z
- 近 30 天下载量：9273（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：157（近 12 个月 157 个）

## 中文简介

BetterCMS MCP服务器 — schema,内容,形式+组件编写工具在管理API之上,通过OAuth设备代码认证.

## 安装

```sh
npm install @bettercms-ai/mcp
```

也可以使用：`pnpm add @bettercms-ai/mcp`、`yarn add @bettercms-ai/mcp`、`bun add @bettercms-ai/mcp`

## README

# 翻译:

更好的CMS( 更好的CMS) [示范背景协议](https://modelcontextprotocol.io/) 服务器,作为本地 stdio 进程。 它与 OAuth 2. 0 设备授权赠款( RFC 8628) 签入: 无粘贴 长生钥匙.

> 大多数人应该使用 **主办** 服务器替换: 添加 `https://mcp.bettercms.ai/mcp` 改为 客户端,或运行 `npx @bettercms-ai/install --mcp`。这个软件包暴露了相同的工具 给只讲Stdio的客户 每个客户端的设置和完整的工具引用 : [https://bettercms.ai/docs/ai/connect-mcp 页面存档备份,存于互联网档案馆](https://bettercms.ai/docs/ai/connect-mcp) 财务报告和审定财务报表 [https://bettercms.ai/docs/ai/mcp-tools (中文(简体) )](https://bettercms.ai/docs/ai/mcp-tools)

## 工具

与主机服务器相同的工具集:页面和部分,内容模型和字段,条目, 包括组件、媒体、表格、标准作业程序、出版和部署等等。 写草稿,除非你 允许在您批准客户端时发布。 探员们从 `bettercms` 技术(`npx @bettercms-ai/install`) (中文(简体) ).

## 使用量

添加到您的 MCP 客户端配置( 如 Claude Desktop / Claude 代码) :

```json
{
  "mcpServers": {
    "bettercms": {
      "command": "npx",
      "args": ["-y", "@bettercms-ai/mcp"]
    }
  }
}
```

在第一个工具上, 调用服务器打印授权提示 **标准** (可见于您的 MCP 客户端日志):

```
┌─ BetterCMS authorization required ─────────────────────────
│ Visit: https://bettercms.ai/activate
│ Enter code: WDJB-MJHT
│ Or open: https://bettercms.ai/activate?code=WDJB-MJHT
└────────────────────────────────────────────────────────────
```

在仪表盘中批准(选择工作空间/项目),服务器缓存 铸币局 到期后自动刷新; 如果刷新符被吊销 重新运行设备流.

## 环境

| 瓦尔 | 默认 | 目的 |
| --- | --- | --- |
| `BETTERCMS_API_URL` | `https://api.bettercms.ai` | API起源(device-auth + Management API). |
| `BETTERCMS_MCP_CREDENTIALS` | `~/.bettercms/mcp-credentials.json` | 托肯缓存路径( 0600). |
| `BETTERCMS_MCP_CLIENT_NAME` | `BetterCMS MCP` | 标签显示在批准屏幕上. |
| `BETTERCMS_MCP_TOOLS` | _(未设定)_ | 要注册的工具, 逗号列表 : `core` (只有核心工具), `abm` (增加反弹道导弹战道), `all`除反导道外,未设置的每个工具都登记。 主机服务器使用相同的列表 `?tools=`。 。 。 . |

## 开发

```bash
bun install
bun run --filter @bettercms-ai/mcp typecheck
bun run --filter @bettercms-ai/mcp test
bun run --filter @bettercms-ai/mcp build
```

## 常见问题

### @bettercms-ai/mcp 是什么？

BetterCMS MCP服务器 — schema,内容,形式\+组件编写工具在管理API之上,通过OAuth设备代码认证\.

### 如何安装 @bettercms-ai/mcp？

在项目目录运行 npm install @bettercms-ai/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bettercms-mcp，可以用 npx bettercms-mcp 直接运行。

### @bettercms-ai/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bettercms-ai/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bettercms-ai/mcp 可以商用吗？

@bettercms-ai/mcp 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @bettercms-ai/mcp 的下载量有多少？

根据 npm 官方下载统计，@bettercms-ai/mcp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 9,273 次，日均约 309 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bettercms-ai/mcp 还在维护吗？

最新版本 0\.95\.0 发布于 2026/11/05（2 天前）；至今共发布 157 个版本，其中过去 12 个月发布了 157 个；首次发布于 2026/06/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。