mcpField
M
monacloud-mcp

monacloud-mcp

本地服务
monacloud.vn云与基础设施01 天前更新
代码仓库访问官网

关于 monacloud-mcp

monacloud-mcp 是供 AI Agent 和其他 MCP 客户端管理 MONA Cloud 服务的 MCP 服务，涵盖应用部署、VPS、数据库、域名、VND 钱包，以及 MONA Pay 和 MONA Mail。

主要功能

  1. 01部署应用并管理 VPS 服务
  2. 02创建 MongoDB、PostgreSQL 和 MySQL 数据库
  3. 03搜索、购买和管理域名
  4. 04管理钱包、预算和账单
  5. 05使用 MONA Pay 与 MONA Mail 工具
  6. 06浏览 MONA Agent 模板

适用场景

  1. 01部署项目并绑定域名
  2. 02为应用创建数据库
  3. 03接收付款并查询转账
  4. 04发送邮件并管理 Agent 收件箱

MCP 相关

它向 MCP 客户端提供 MONA Cloud 的部署、数据库、域名、账单、支付、邮件和模板工具，支持本地 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 登录和一个 VND 钱包，即可部署应用、运行 VPS、数据库和 Base 项目、管理域名、通过 MONA Pay 收款、通过 MONA Mail 发送邮件，以及在 Claude Code、Codex、Cursor 或任何 MCP 客户端中浏览 MONA Agent 模板。

安装

需要 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。

快速开始

例如，让你的 Agent 执行：“从当前目录将此项目部署到 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

上传内容为最大 80 MiB 的 ZIP 文件。上传会遵循 .gitignore/.dockerignore 规则，并排除 .env*、*.pem、.git、node_modules 和符号链接。Git 仓库可使用 repo_url 而非 local_dir 进行部署。详情请参阅：docs/local-deploy.md。

如果钱包余额不足，Agent 会调用 cloud_topup(amount)。响应中包含 qr_ascii（在终端中绘制的 VietQR 码）、qr_file（PNG）、qr_url、银行、账号、金额和转账备注。用户使用银行应用扫描二维码，然后 Agent 会轮询 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 会以 JSON 格式返回，包含 code、message、next_step 和 request_id，方便 Agent 充值或调高预算后重试。

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
  • Agent 收件箱：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、skills）。
  • 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（域名购买）。
沙盒

将 sandbox: true 传递给 cloud_vps_create、cloud_db_create、cloud_service_start、cloud_service_rebuild、cloud_app_create、cloud_base_create 或 cloud_agent_deploy，或设置 MONACLOUD_SANDBOX=1，即可模拟调用。沙盒会跳过余额检查，不会创建真实基础设施，也不会扣款，并会返回包含成本估算的 sandbox: true。

配置

变量默认值用途
MONACLOUD_TOKENMONA Pass 访问令牌或 PAT；优先于令牌存储（适用于 CI）
MONACLOUD_SANDBOX设置为 1，即可在沙盒模式下运行受支持的计算调用
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本地 Agent 模板目录
MONACLOUD_TEMPLATES_URLmona-agent-templates on GitHub远程目录；设置为空字符串即可禁用

为兼容性，仍会读取旧版变量（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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。