mcpField
M
monacloud-mcp

monacloud-mcp

ローカル
monacloud.vnクラウド・インフラ01 日前に更新
リポジトリ公式サイト

monacloud-mcp について

monacloud-mcpは、AIエージェントやMCPクライアントからMONA Cloudを操作するMCPサーバーです。アプリやVPSのデプロイ、データベース、ドメイン、VND決済、MONA Pay、MONA Mailを扱います。

主な機能

  1. 01アプリのデプロイとVPS管理
  2. 02MongoDB、PostgreSQL、MySQLの作成
  3. 03ドメインの検索、購入、管理
  4. 04ウォレット、予算、請求の管理
  5. 05MONA PayとMONA Mailのツール
  6. 06MONA Agentテンプレートの閲覧

活用シーン

  1. 01プロジェクトのデプロイとドメイン設定
  2. 02アプリ用データベースの作成
  3. 03決済の受付と入金確認
  4. 04メール送信とエージェント受信箱の管理

MCP 対応

デプロイ、データベース、ドメイン、請求、決済、メール、テンプレートを操作するツールをMCPクライアントに公開します。ローカルのstdio接続と、ホスト型Streamable HTTPエンドポイントに対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "vn-monacloud-monacloud": {
      "command": "npx",
      "args": [
        "-y",
        "monacloud-mcp"
      ],
      "env": {
        "MONACLOUD_TOKEN": "<MONACLOUD_TOKEN>",
        "MONACLOUD_SANDBOX": "<MONACLOUD_SANDBOX>"
      }
    }
  }
}
起動コマンドnpx -y monacloud-mcp
設定が必要な環境変数
MONACLOUD_TOKENシークレットOptional MONA Pass token (vc_live_* or JWT). Not needed for domain search/reserve; run `monacloud-mcp login` to buy, deploy and pay.
MONACLOUD_SANDBOXSet 1 to simulate paid actions (no charge).

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmonacloud-mcp0.11.1

ツール

186

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

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_TOKENMONA Pass アクセストークンまたは PAT。トークンストアより優先されます（CI で便利です）
MONACLOUD_SANDBOX1 にすると、対応するコンピューティング呼び出しをサンドボックスモードで実行します
MONACLOUD_ISSUERhttps://pass.monacloud.vn/realms/monaOIDC 発行者
MONACLOUD_BILLING_URLhttps://billing.monacloud.vn請求およびウォレット API
MONACLOUD_APIhttps://api.monacloud.vnコンピューティング API
MONAPAY_APIhttps://api.monapay.vnMONA Pay API
MONAMAIL_APIhttps://api.monamail.vnMONA Mail API
MONACLOUD_CONSOLE_URLhttps://monacloud.vn/console人間による手順で返されるコンソール URL
MONACLOUD_CONFIG_DIR~/.config/monacloudトークンおよびリンクのキャッシュディレクトリ
MONACLOUD_TEMPLATES_DIR~/monacloud/templatesローカルのエージェントテンプレートカタログ
MONACLOUD_TEMPLATES_URLGitHub 上の 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 の一部です。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。