# @roxyon/mcp 中文文档

规范地址：https://npmcn.com/package/%40roxyon/mcp/

版本：0\.11\.0
npm 元数据更新时间：2026-11-02T07:41:16.476Z
中文译文更新时间：2026-11-02T09:00:08.907Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40roxyon/mcp
原文对照：https://npmcn.com/package/%40roxyon/mcp/?lang=original
项目主页：https://github.com/bea-technology/roxyon-devtools#readme
源码仓库：https://github.com/bea-technology/roxyon-devtools

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

- 包体积（解压后）：337 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：5 个
- 首次发布：2026-09-02T13:57:49.386Z
- 最新版本发布：2026-11-02T07:41:16.102Z
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Roxyon的模型上下文协议服务器-允许任何mcp功能的AI助手使用LumenJS构建，使用Roxyon BaaS，并部署到Roxyon基础设施。

## 安装

```sh
npm install @roxyon/mcp
```

也可以使用：`pnpm add @roxyon/mcp`、`yarn add @roxyon/mcp`、`bun add @roxyon/mcp`

## README

# @roxyon / mcp

用于Roxyon的协议服务器。给任何有mcp功能的AI助手 能够构建LumenJS应用程序，使用Roxyon BaaS，以及部署应用程序和web 项目到Roxyon基础设施。

运行在 **的头**。计划使用OAuth进行远程Streamable-HTTP传输 （需要M1.5个人访问令牌工作）。

## 安装

```bash
npm i -g @roxyon/mcp    # or use npx, below
```

使用CLI验证一次（MCP服务器重用其存储的登录名）：

```bash
npm i -g @roxyon/cli
roxyon login
```

…或一组 `ROXYON_TOKEN` 在服务器环境中（CI / headless）。

## 将其添加到客户端

**克劳德代码** - - - - - - `.mcp.json` 在一个项目中，或者 `claude mcp add`：

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

**游标/风帆/斜线** -在他们的MCP设置相同的形状。

**双子座CLI** - - - - - - `~/.gemini/settings.json` → `mcpServers` →相同的形状。

通过 `ROXYON_TOKEN` (可选 `ROXYON_API_URL`， `ROXYON_CONSOLE_URL`)通过客户的 `env` 字段，如果不使用存储的登录名。

## 它暴露了什么

**工具** - - - - - - `roxyon_whoami`， `roxyon_list_domains`， `roxyon_list_apps`， `roxyon_init`， `roxyon_deploy` (管制,除非 `confirm:true`)， `roxyon_app_status`， `roxyon_logs`， `roxyon_restart`， `roxyon_env_get`， `roxyon_env_set`， `roxyon_link_github`。每个有副作用的工具都需要 `confirm:true`.

**资源** - - - - - - `roxyon://docs/lumenjs` （完整的LumenJS V1参考）， `roxyon://docs/baas`， `roxyon://docs/deploy`.

**提示** - - - - - - `scaffold-lumen-app`， `deploy-to-roxyon`.

## 典型的流

1.  助手读道 `roxyon://docs/lumenjs` + `roxyon://docs/baas`，他写道。 应用程序。
2.  `roxyon_init { dir }` →写道 `roxyon.json`.
3.  `roxyon_deploy { dir }` →演练计划。
4.  `roxyon_deploy { dir, confirm: true }` →构建，上传，等待它离开 live（应用运行时）并报告URL或失败原因。

## 常见问题

### @roxyon/mcp 是什么？

Roxyon的模型上下文协议服务器-允许任何mcp功能的AI助手使用LumenJS构建，使用Roxyon BaaS，并部署到Roxyon基础设施。

### 如何安装 @roxyon/mcp？

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

### @roxyon/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/roxyon\_\_mcp 是否存在。

### @roxyon/mcp 支持 ESM 还是 CommonJS？

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

### @roxyon/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @roxyon/mcp 可以商用吗？

@roxyon/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @roxyon/mcp 还在维护吗？

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