关于 roxyon
roxyon 是面向 AI 助手的 MCP 服务,用于构建 LumenJS 应用、使用 Roxyon BaaS,并将项目部署到 Roxyon 基础设施。它提供部署和应用管理操作,以及文档与提示词。
主要功能
- 01初始化 LumenJS 项目
- 02支持预览部署计划
- 03查看应用状态和日志
- 04管理环境变量
- 05访问 LumenJS、BaaS 和部署文档
适用场景
- 01搭建 LumenJS 应用
- 02确认前预览部署计划
- 03检查应用状态或日志
MCP 相关
通过 stdio 运行,向 MCP 客户端提供 Roxyon 工具、文档资源和提示词。产生副作用的工具需要设置 `confirm:true`。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.roxyon.com/mcpclaude mcp add --transport http bea-technology-roxyon https://mcp.roxyon.com/mcp{"mcpServers":{"bea-technology-roxyon":{"type":"http","url":"https://mcp.roxyon.com/mcp"}}}在 Cursor 中打开{"servers":{"bea-technology-roxyon":{"type":"http","url":"https://mcp.roxyon.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"bea-technology-roxyon":{"type":"http","url":"https://mcp.roxyon.com/mcp"}}}{"mcpServers":{"bea-technology-roxyon":{"serverUrl":"https://mcp.roxyon.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
@roxyon/mcp
适用于 Roxyon 的模型上下文协议服务。让任何支持 MCP 的 AI 助手都能构建 LumenJS 应用、使用 Roxyon BaaS,并将应用和 Web 项目部署到 Roxyon 基础设施。
通过 stdio 运行。计划支持带 OAuth 的远程 Streamable-HTTP 传输(需要先完成 M1.5 个人访问令牌相关工作)。
安装
npm i -g @roxyon/mcp # or use npx, below
使用 CLI 登录一次(MCP 服务会复用已存储的登录信息):
npm i -g @roxyon/cli
roxyon login
……或者在服务的环境中设置 ROXYON_TOKEN(CI / 无头环境)。
将其添加到客户端
Claude Code — 在项目中创建 .mcp.json,或使用 claude mcp add:
{
"mcpServers": {
"roxyon": { "command": "npx", "args": ["-y", "@roxyon/mcp"] }
}
}
Cursor / Windsurf / Cline — 在它们的 MCP 设置中采用相同的结构。
Gemini CLI — 在 ~/.gemini/settings.json 的 mcpServers 中采用相同的结构。
未使用已存储的登录信息时,请通过客户端的 env 字段传入 ROXYON_TOKEN(以及可选的 ROXYON_API_URL、ROXYON_CONSOLE_URL)。
提供的功能
工具 — 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。
典型流程
- 助手读取
roxyon://docs/lumenjs+roxyon://docs/baas,编写应用。 roxyon_init { dir }→ 写入roxyon.json。roxyon_deploy { dir }→ 生成试运行计划。roxyon_deploy { dir, confirm: true }→ 构建、上传,并等待应用上线(适用于应用运行时),然后报告 URL 或失败原因。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。