roxyon

@roxyon/mcp

Roxyon 用の Model Context Protocol サーバーです。MCP 対応のあらゆる AI アシスタントが、LumenJS アプリの構築、Roxyon BaaS の利用、Roxyon インフラへのアプリや Web プロジェクトのデプロイを行えるようにします。

stdio で動作します。OAuth を使うリモート Streamable-HTTP トランスポートは、今後対応予定です（M1.5 Personal Access Token の作業が必要です）。

インストール

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。

一般的な流れ

1. アシスタントが roxyon://docs/lumenjs と roxyon://docs/baas を読み、アプリを書きます。
2. roxyon_init { dir } → roxyon.json を書き込みます。
3. roxyon_deploy { dir } → ドライランの計画を表示します。
4. roxyon_deploy { dir, confirm: true } → ビルドとアップロードを行い、アプリのランタイムがライブになるまで待機して、URL または失敗理由を報告します。