monadomain-mcp

monacloud-mcp

MONA Cloud 用の MCP サーバーです。MONA Pass で一度ログインし、1 つの VND ウォレットを使って、アプリのデプロイ、VPS の実行、データベースや Base プロジェクトの作成、ドメインの管理、MONA Pay による決済の受付、MONA Mail によるメールの送信、MONA Agent テンプレートの閲覧ができます。Claude Code、Codex、Cursor、または任意の MCP クライアントから利用できます。

インストール

Node.js 20 以降が必要です。

OAuth デバイスフローで一度サインインします。

npx -y monacloud-mcp login

コマンドを実行すると、pass.monacloud.vn の URL とデバイスコードが表示されます。確認後、リフレッシュトークンが ~/.config/monacloud/token.json に保存されます（ディレクトリのモードは 0700、ファイルのモードは 0600）。サーバーはアクセストークンを自動的に更新し、トークンをログに記録することはありません。

npx -y monacloud-mcp whoami   # show the signed-in MONA Pass profile
npx -y monacloud-mcp logout   # remove stored tokens and linked credentials

サインインしなくても、ドメインの検索と予約ができます。

Claude Code

claude mcp add monacloud -- npx -y monacloud-mcp

Codex（~/.codex/config.toml）

[mcp_servers.monacloud]
command = "npx"
args = ["-y", "monacloud-mcp"]

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "monacloud": {
      "command": "npx",
      "args": ["-y", "monacloud-mcp"]
    }
  }
}

リモートエンドポイント

ホスト型の Streamable HTTP エンドポイントを https://mcp.monacloud.vn/mcp で利用できます。リモート MCP サーバーに対応するクライアント（Claude.ai のカスタムコネクター、Cursor、Codex、ChatGPT の開発者モード）では、初回利用時に MONA Pass が開き、サインインできます。詳しくはdocs/remote.mdをご覧ください。

クイックスタート

エージェントに、たとえば「現在のディレクトリにあるこのプロジェクトを MONA Cloud にデプロイして」と依頼します。

一般的な実行例：

cloud_app_detect({ local_dir: "/absolute/path/to/project" })            // offline: stack, port, start command, env names
cloud_app_create({ local_dir: "/absolute/path/to/project", name: "shop", sandbox: true })  // estimate only
// after the user approves the cost
cloud_app_create({ local_dir: "/absolute/path/to/project", name: "shop" })
cloud_app_domain_add({ app_id: "<app_id>", host: "shop.example.vn" })  // returns CNAME instructions

アップロードされる ZIP のサイズは最大 80 MiB です。.gitignore／.dockerignore の設定を尊重し、.env*、*.pem、.git、node_modules、シンボリックリンクは除外されます。Git リポジトリは、local_dir の代わりに repo_url を指定してデプロイできます。詳しくはdocs/local-deploy.mdをご覧ください。

ウォレット残高が不足している場合、エージェントは cloud_topup(amount) を呼び出します。応答には qr_ascii（ターミナルに表示される VietQR コード）、qr_file（PNG）、qr_url、銀行名、口座番号、金額、振込メモが含まれます。ユーザーは銀行アプリでコードをスキャンし、cloud_topup_status(topup_id) が paid になるまでエージェントがポーリングします。

使い方

ツール名には snake_case を使用します。ほとんどの cloud_* ツールには、以前のプロンプト向けに同じスキーマの vibecloud_* エイリアスもあります。以下のグループには代表的なツールを示しています。利用できるすべてのツールは MCP クライアントで確認できます。

アプリとデプロイ

• cloud_app_detect、cloud_app_create、cloud_app_deploy、cloud_app_list、cloud_app_get、cloud_app_logs、cloud_app_env_set、cloud_app_domain_add、cloud_app_delete、cloud_app_host_list
• VPS とサービス：cloud_vps_create（plan_code による時間単位または月単位）、cloud_services_list、cloud_service_start、cloud_service_stop、cloud_service_rebuild、cloud_job_status
• 長時間実行されるジョブは最大 600 秒まで待機します。クライアントのタイムアウトが短い場合は、wait: false を指定し、cloud_job_status をポーリングしてください。

データベースと Base（ベータ版）

• cloud_db_create：MongoDB、PostgreSQL、MySQL。
• cloud_base_create、cloud_base_list、cloud_base_get、cloud_base_credentials、cloud_base_delete：アプリと同じアカウントおよびウォレットで利用できる Base プロジェクト（API キーと studio URL を備えた Postgres）。cloud_base_credentials は anon_key、service_key、db_url を返します。これらはシークレットとして扱ってください。

ドメイン

• 検索と価格の確認（ログイン不要）：cloud_domain_search、cloud_domain_suggest、cloud_domain_tlds、cloud_domain_tld_groups
• 購入：cloud_domain_buy（サインイン済みの場合）、またはアカウントをまだ持っていないユーザー向けの cloud_domain_reserve → cloud_domain_reserve_status → cloud_domain_claim。保留を解除するには cloud_domain_reserve_release を使います。
• 登録者情報と .vn の認証：cloud_domain_registrant_get、cloud_domain_registrant_set、cloud_domain_verify_start、cloud_domain_verify_status、cloud_domain_wait
• 管理：cloud_domain_list、cloud_domain_renew、cloud_domain_dns_list／_add／_update／_delete、cloud_domain_ns_set、cloud_domain_attach（SSL 付きでドメインをアプリに向ける）、cloud_domain_health、cloud_domain_webhook_set

ウォレットと請求

• cloud_whoami、cloud_balance、cloud_ledger、cloud_usage、cloud_services
• cloud_topup、cloud_topup_status、cloud_credit_redeem
• cloud_prices、cloud_packages、cloud_plan_list、cloud_subscription_list、cloud_subscription_update、cloud_invoice_list、cloud_invoice_pdf
• 支出管理：cloud_budget_set、cloud_budget_get、cloud_token_limit
• 紹介：cloud_affiliate_link、cloud_affiliate_stats、cloud_affiliate_claim

有料のコンピューティング操作の前に、サーバーはウォレット残高を確認します（cloud_service_stop がブロックされることはありません）。HTTP 402 insufficient_funds と 402 budget_exceeded は、code、message、next_step、request_id を含む JSON として返されるため、エージェントはチャージするか予算を引き上げて再試行できます。

MONA Pay

monapay-mcp のすべてのツールが再エクスポートされます（依存関係 ^0.5.5）。例：monapay_create_qr、monapay_create_checkout、monapay_link_bank_start、monapay_list_transactions、monapay_create_webhook、monapay_test_webhook、monapay_verify_signature。monapay_link は MONA Pass のセッションを MONA Pay の認証情報と交換し、それらを ~/.config/monacloud/links.json にキャッシュします。

MONA Mail

mail_* ツールは同じ MONA Pass セッションを使用します。Mail アカウントは最初のリクエスト時に作成されます。

• 送信：mail_send（sandbox: true に対応）、mail_status、mail_list、mail_stats、mail_template_create
• ドメイン：mail_domain_add、mail_domain_verify、mail_domain_cloudflare、mail_domains_list
• アプリ用 API キー：mail_api_key_create、mail_api_keys_list、mail_api_key_revoke
• Webhook と抑制：mail_webhook_create、mail_webhooks_list、mail_webhook_test、mail_suppressions_list、mail_suppression_remove
• エージェントの受信トレイ：mail_inbox_create、mail_inbox_list、mail_inbox_messages、mail_inbox_message、mail_inbox_reply、mail_inbox_wait
• アカウントとプラン：mail_account、mail_plans、mail_plan_set

すべての POST リクエストには Idempotency-Key（idempotency_key の値、または自動生成された値）が含まれます。API キーは一度だけ返されるため、アプリの .env に MONAMAIL_API_KEY として書き込んでください。

MONA Agent テンプレート

• agent_templates_list：最初に MONACLOUD_TEMPLATES_DIR を読み込み、次に公開されている mona-agent-templates カタログを読み込みます。その後、組み込みのフォールバックを使用します。
• agent_templates_get(template)：テンプレートファイル（README.md、AGENTS.md、tools.json、deploy.md、CHECKLIST.md、スキル）を返します。
• agent_deploy / cloud_agent_deploy：現在は agent_runtime_pending を返すプレースホルダーです。

リソースとプロンプト

• monacloud://llms：MONA Cloud スタックの機械可読な説明です。
• monacloud://status：MONA Pass、Billing、コンピューティング、MONA Pay、MONA Mail のヘルス状態を集約したものです。
• プロンプト：dung-app-ban-hang-monacloud（VPS、データベース、決済、Webhook、デプロイ）、gui-mail-otp-monamail（OTP メールのセットアップ）、mua-ten-mien-monacloud（ドメインの購入）。

サンドボックス

cloud_vps_create、cloud_db_create、cloud_service_start、cloud_service_rebuild、cloud_app_create、cloud_base_create、cloud_agent_deploy に sandbox: true を渡すか、MONACLOUD_SANDBOX=1 を設定すると、呼び出しをシミュレートできます。サンドボックスでは残高チェックがスキップされ、実際のインフラは作成されず、ウォレットへの請求も行われません。また、コストの見積もりとともに sandbox: true が返されます。

設定

変数	デフォルト	用途
MONACLOUD_TOKEN		MONA Pass アクセストークンまたは PAT。トークンストアより優先されます（CI で便利です）
MONACLOUD_SANDBOX		1 にすると、対応するコンピューティング呼び出しをサンドボックスモードで実行します
MONACLOUD_ISSUER	https://pass.monacloud.vn/realms/mona	OIDC 発行者
MONACLOUD_BILLING_URL	https://billing.monacloud.vn	請求およびウォレット API
MONACLOUD_API	https://api.monacloud.vn	コンピューティング API
MONAPAY_API	https://api.monapay.vn	MONA Pay API
MONAMAIL_API	https://api.monamail.vn	MONA Mail API
MONACLOUD_CONSOLE_URL	https://monacloud.vn/console	人間による手順で返されるコンソール URL
MONACLOUD_CONFIG_DIR	~/.config/monacloud	トークンおよびリンクのキャッシュディレクトリ
MONACLOUD_TEMPLATES_DIR	~/monacloud/templates	ローカルのエージェントテンプレートカタログ
MONACLOUD_TEMPLATES_URL	GitHub 上の mona-agent-templates	リモートカタログ。無効にするには空文字列を設定します

レガシー変数（VIBECLOUD_API、VIBECLOUD_API_URL、VIBECLOUD_API_TOKEN、MONAPAY_CLIENT_ID、MONAPAY_CLIENT_SECRET、MONAPAY_LINK_PATH、VIBECLOUD_LINK_PATH）も、互換性のため引き続き読み込まれます。

開発

npm install
npm run build
npm test

テストでは、Node.js 組み込みランナー、実際の stdio MCP トランスポート、ローカル HTTP モックを使用します。インターネットへの通信は行いません。

リモートサーバーをセルフホストする方法については、deploy/remote/README.md を参照してください。

ウェブサイト：monacloud.vn。

ライセンス

MIT

MONA Cloud MCP は The MONA Group による MONA Cloud の一部です。