ohmyho.st

ohmyho.st MCP 服务

ohmyho.st 的本地 MCP 服务，由编码 Agent 运行。它通过 stdio 与 Codex、Claude Code、Cursor、Hermes 或 OpenClaw 一同运行，让 Agent 使用用户授予的权限部署用户的 GitHub 应用，并管理其数据库、域名、邮件、用量和预算。Agent 也通过它联系 ohmyho.st 支持团队。

版本 0.1.38 · npm · Node.js 22 或更高版本 · release.json

此仓库镜像了 npm 软件包 @amerged/ohmyhost-mcp 中发布的源代码。每次发布都会从注册表 tarball 替换此仓库中的内容，因此这里不会合并拉取请求；如需报告问题，请通过你的 Agent 提交（见下方“支持”部分）。

安装

npm install --global @amerged/ohmyhost-cli @amerged/ohmyhost-mcp
export OHMYHOST_ENVIRONMENT=production
ohmyhost login --json

之前从 ohmyho.st 发布档案安装过客户端？请先使用 npm uninstall --global @ohmyhost/product-cli @ohmyhost/mcp 将其移除：这两个安装包都会提供 ohmyhost 和 ohmyhost-mcp 命令，而 npm 会因 EEXIST 阻止第二次安装。

在 Agent 中注册

Harness	注册本地服务	在运行中的 Harness 中确认
Codex	codex mcp add ohmyho --env OHMYHOST_ENVIRONMENT=production -- ohmyhost-mcp	如果提示，请重新加载；调用 identity_get 并读取 Skill 资源。
Claude Code	claude mcp add --transport stdio --scope user --env OHMYHOST_ENVIRONMENT=production ohmyho -- ohmyhost-mcp	打开 /mcp，确认已连接并调用 identity_get。
Cursor	将无令牌的 https://ohmyho.st/mcp.json 服务合并到现有的全局或项目 MCP 配置中。	在设置中确认；当前 CLI 支持 agent mcp list-tools ohmyho。解析已安装的可执行文件/帮助信息。
Hermes	hermes mcp add ohmyho --command ohmyhost-mcp --env OHMYHOST_ENVIRONMENT=production	运行 hermes mcp test ohmyho，然后重新加载 Agent 会话。
OpenClaw	如果已安装的原生注册表支持，请运行 openclaw mcp add ohmyho --command ohmyhost-mcp --env OHMYHOST_ENVIRONMENT=production。	运行 openclaw mcp probe ohmyho --json，然后确认运行时可见的工具。

确认连接并调用 identity_get；仅保存配置并不代表连接已正常工作。

身份验证

有两种身份验证方式：从私有凭据源将 OHMYHOST_TOKEN 加载到服务环境中，或使用 ohmyhost login --json 登录，让 MCP 使用已保存的登录信息。如果保存了多个登录信息，请在每次调用时传入 profile_name（profile_list 会显示名称），或者在 OHMYHOST_ENVIRONMENT 旁设置 OHMYHOST_PROFILE=NAME，将服务绑定到一个登录信息；已绑定的服务会拒绝针对其他登录信息的调用（profile_context_mismatch）。为用户注册的服务会为这台计算机上的所有会话提供服务，因此只有在客户提出要求时才进行绑定，并在之后重新加载。无论在哪里设置，令牌都会优先使用，且无需浏览器。新的用户 API 令牌为可选项，撤销前始终有效；门户网站只会显示新令牌一次，而 CLI/MCP 创建的令牌会直接保存到选定的私有 env 文件中。登录信息和令牌的有效期相互独立。

不要将令牌放入共享或已提交的 MCP 配置中；公开配置中只包含 OHMYHOST_ENVIRONMENT=production。

工具

• application_domain_identity_authorization_revoke：在明确确认后，撤销当前应用身份的 DNS 授权。
• application_domain_identity_authorization_status：读取所选项目应用域名身份的 DNS 授权状态。
• application_domain_identity_authorize：请求 Cloudflare 明确同意在当前修订版本中写入此项目主机名所有权验证记录。
• application_domain_identity_declare：在部署前声明预期的客户应用主机名。
• application_domain_identity_get：读取项目预期的应用主机名、当前修订版本和所有权证明。
• application_domain_identity_revoke：在明确确认后，仅撤销所选的当前应用域名证明。
• application_domain_identity_verify：独立验证当前项目和主机名的 TXT 验证记录，不依赖部署。
• billing_checkout_create：仅限所有者：创建或恢复托管式 Checkout。
• billing_checkout_get：仅限所有者：查看原始 Checkout，并核对已确认的额度和退款，不会再次购买。
• billing_portal_create：仅限所有者：向用户提供短时有效的 Stripe 门户 URL，用于查看发票、支付方式或设置在账期结束时取消。
• billing_recharge_configure：仅限所有者：启用或停用离线自动付款。
• billing_recharge_get：仅限所有者：读取自动充值授权、消费限额和付款交接状态。
• database_access_create：为此项目自己的 Dev 或 Prod 数据库签发限时 PostgreSQL 凭据。
• database_access_list：列出此项目已签发的数据库凭据及其状态（有效、过期或已撤销）。
• database_access_revoke：立即撤销一项已签发的数据库凭据：结束打开的会话并移除其 PostgreSQL 角色。
• database_compute_get：读取当前托管数据库的规格、内存、区域和计算状态，不运行 SQL，也不会唤醒数据库。
• database_compute_set：为现有数据库选择标准或性能计算规格：Free 为 0.25 CU/1 GB，Paid 为 0.5 CU/2 GB。
• database_query：读取一条所有者已授权的 Dev 或 Prod 数据库查询（最多 100 行，超时为 5 秒）。
• database_write：在所选 Dev 或 Prod 数据库中执行一项明确授权的 INSERT、UPDATE 或 DELETE/upsert 操作。
• delete_execute：执行已审核的项目删除操作
• delete_plan：规划完整的项目删除操作
• deployment_create：启动已审核的部署计划
• deployment_get：获取一项部署
• deployment_logs：列出一项部署的最新规范化诊断信息（构建、控制、运行时和函数故障及其目录代码）。
• deployment_plan：规划不可变部署。
• deployments_list：列出项目部署
• domain_cloudflare_authorize：先检查 domain_cloudflare_status，并复用有效的匹配授权。
• domain_cloudflare_status：读取项目客户 DNS 授权状态、区域、权限范围和到期时间，不涉及凭据。
• domain_paid_apply：声明或启用明确请求的客户主机名。
• domain_paid_delete：仅删除明确指定项目中存储的客户主机名/路由及其所属 DNS 记录。
• domain_paid_plan：在首次 Prod 部署之前或之后，为客户自有的生产主机名制定计划。
• domain_paid_status：读取 DNS/TLS 状态和 Paid 域名的实际访问权限。
• feedback_status：读取你提交的反馈回执状态以及 ohmyho.st 客户可见的回复：已收到、审核中、已规划、进行中、已解决（修复已在指定版本上线）或已关闭（附带说明）。
• feedback_submit：向 ohmyho.st 报告 Bug、疑似问题或功能请求。
• function_runs_list：列出某环境最新的计划函数运行记录（functions.crons）：每个到期 UTC 分钟一条记录，包含状态、尝试次数、计划处理程序返回的状态和耗时。
• github_connect：所有者或管理员：为此工作区连接一次 GitHub。
• github_status：读取此工作区的 GitHub 连接状态。
• identity_get：获取此调用所使用的 ohmyho.st 客户/Agent 身份：用户和账户邮箱、限定范围的组织 ID 和名称，以及上下文中提供该身份的已保存登录或 OHMYHOST_TOKEN。
• mail_binding_detach：使用当前修订版本并在明确确认后，仅解除此项目的发件绑定。
• mail_binding_get：读取 Prod 发件人绑定，以及每个项目的 From 地址、默认 From 和默认 Reply-To。
• mail_binding_set：附加已验证的工作区发件人，或更新其项目设置。
• mail_domain_delete：在项目保持活动状态时停用项目邮件域名；使用其 Prod 环境 ID。
• mail_domain_set：使用项目的 Prod 环境 ID 配置一个生产邮件域名。
• mail_domain_status：读取项目生产邮件域名的发送和接收就绪状态，以及准确的 DNS 记录。
• mail_message_get：在硬性 72 小时过期时间之前，仅读取此项目在 Prod 中接收的邮件。
• mail_message_retry：在共享额度内重试 Prod 客户 Webhook：首次尝试后最多重试三次，且所有重试均须在收到邮件后的 72 小时内完成。
• mail_messages_list：列出 Prod 环境中归属此环境且未超过 72 小时的交接元数据。
• mail_setup：仅当客户需要邮件或应用声明 mail.enabled 时，使用项目 Prod 环境 ID 配置客户的一个生产邮件域名；托管不需要邮件域名，也不会自动注册邮件域名。
• mail_status：读取项目的一个生产邮件域名的发送和接收就绪状态，以及准确的 DNS 记录。
• mail_webhook_disable：停用项目 Prod 邮件域名的接收功能并移除其 Webhook；现有邮件内容将无法访问。
• mail_webhook_set：使用 Prod 环境 ID，在项目的 Prod 应用中设置必需的 HTTPS 端点。
• mail_webhook_verify：向 Prod 应用端点发送签名测试，并在其接受事件后启用接收功能。
• operation_get：获取持久化操作状态以及当前部署进度/核对指引。
• operation_logs：读取可用的操作事件，最长等待 10 秒；若达到 max_events 或出现终止事件，则提前停止。
• operation_reconcile：启动一次经明确确认的提供商核对尝试
• organization_account_get：仅限所有者：读取实际生效的 Free/Paid 方案、其 Stripe 或授予来源、账期结束时到期的可用月度额度、Paid 期间可结转但降级到 Free 时会到期的充值额度、预留额度和下一次到期时间。
• organization_create：创建由已登录用户拥有的组织。
• organization_credits_get：读取所有者共享的组织额度池、七天宽限期的 grace_started_at/grace_expires_at 和已公布的 rate_cards。
• organization_list：列出所选登录用户所属的工作区，以及该登录当前限定使用的工作区。
• organization_usage_get：读取按项目、环境和已公布计量项/费率统计的当月 UTC 已入账用量。
• organization_use：将尚未关联组织的已保存登录绑定到一个工作区，以便后续调用在该工作区内执行。
• powered_by_flag_get：读取生产站点是否显示可选的“Powered by ohmyho.st”标记。
• powered_by_flag_set：仅限所有者，须先征得用户同意：在生产站点右侧显示或隐藏小型“Powered by ohmyho.st”标记。
• profile_list：列出此计算机上已保存的 ohmyho.st 登录信息：每项包含名称、用户和组织，绝不包含令牌。
• project_budget_get：读取所有者项目的当月 UTC 预算、已计量用量和未结预留额度。
• project_budget_set：以 microcredits 为单位设置所有者可选的月度项目预算（1000000 = 一个额度）。
• project_context_get：读取最新项目状态、DNS/邮件后续操作、已授权用量和有数量限制的共享备注。
• project_create：创建 ohmyho.st 项目。
• project_data_change：仅限所有者：在客户明确确认后，执行完全符合审核内容的 project_data_plan。
• project_data_plan：仅限所有者：规划 Dev/Prod 数据分配变更，并检查将保留或移除的数据、文件、部署和数据库登录信息。
• project_dev_access_create：为受保护的 Dev 应用创建仅限所有者使用、有效一小时且只能使用一次的访问链接。
• project_dev_access_mode_set：仅限所有者：选择公开 Dev（无需平台令牌）或受保护的 Dev（需要分享链接）。
• project_dev_share_link_get：仅限所有者：获取或创建持久的受保护 Dev 链接。
• project_dev_share_link_revoke：仅限所有者：立即撤销持久 Dev 链接和活动会话，不更改 Dev 访问模式。
• project_dev_share_link_rotate：仅限所有者：替换持久 Dev 链接，并立即撤销旧链接和会话。
• project_export_create：仅限所有者：请求异步生成带密码加密的 SQL ZIP，即使额度为零也可请求。
• project_export_get：仅限所有者：读取原始 SQL ZIP 导出的进度/错误信息和已验证的下载 URL。
• project_get：获取一个项目
• project_handle_check：在向客户提供项目地址前，检查该地址是否可用。
• project_handle_set：在 project_handle_check 确认地址可用后，将项目迁移到客户选择的地址。
• project_notes_set：保存共享项目待办事项，最多 250 行 / 16384 UTF-8 字节。
• project_status：获取源码、Dev/Prod 两个环境 ID、部署 URL、Dev 访问模式、最新操作和清理状态。
• projects_list：列出当前身份可见的项目
• promotion_execute：使用未更改的计划保护条件，执行经明确确认的 Dev 到 Prod 推广。
• promotion_plan：规划将当前 Dev 构件推广到 Prod，不重新构建。
• referral_link_get：读取工作区可供分享的推荐链接。
• rollback_execute：执行已审核的回滚操作
• rollback_plan：规划回滚操作
• secret_delete：删除环境密钥
• secret_set_command：返回用于设置密钥的仅通过 stdin 传值的 CLI 命令；密钥值不会进入 MCP。
• secrets_list：列出密钥元数据，不包含密钥值
• source_changes：根据已读取的代码版本和父提交，原子性地保存一批文件变更。
• source_diff：比较两个托管版本，不更改文件或部署。
• source_file：读取一个托管源文件及其确切哈希值和模式。
• source_files：列出指定版本的确切托管源码树；省略 commit_sha 可读取当前 main。
• source_get：获取关联的源码状态。
• source_initialize：为尚未绑定的项目创建托管版本历史。
• source_inspect：无需登录即可读取本地工作目录、Git/工作树、monorepo 和经过净化的远程上下文。
• source_link：关联由工作区 GitHub 连接授权的代码仓库。
• source_publish：仅限本地 MCP：采集当前经过筛选的文件（包括未提交/新建文件），并保存一个托管版本，不导入 Git 历史。
• source_publish_complete：轮询操作后，完成本地待处理的源码发布。
• source_restore：将较早的托管文件树恢复为新版本，并以当前代码版本和父提交为依据。
• source_upload：在响应不确定后，查看确切的托管快照上传状态。
• source_versions：读取此项目的托管版本历史；next_commit_sha 用于继续读取同一历史分页。
• token_create：交互式登录后创建自己的永不过期 API 令牌，并将其保存到所选私有环境文件中。
• token_revoke：交互式登录并明确确认后，撤销自己的一个 API 令牌。
• tokens_list：交互式登录后列出自己的令牌元数据。
• workspace_mail_domain_create：创建一个归工作区所有的事务性发件域名。
• workspace_mail_domain_dns_authorize：请求用户授权此工作区所选发件人、区域和修订版本的 Cloudflare 操作。
• workspace_mail_domain_dns_revoke：在明确确认后，撤销当前修订版本中所选工作区发件人的 DNS 授权。
• workspace_mail_domain_dns_status：读取准确的工作区发件人 DNS 授权状态。
• workspace_mail_domain_get：读取一个已授权工作区资源的发件人验证状态、生命周期、修订版本和 DNS 记录。
• workspace_mail_domain_retire：仅在解除所有发送和入站引用且提供商操作已完成后，停用明确选定的工作区发件人。
• workspace_mail_domains_list：仅列出此账户和已连接客户端有权读取的工作区发件人域名。 完整描述和输入架构请参阅工具目录。

技能与支持

• MCP 配置指南
• 入门 Skill和 Skill 索引；该服务也会将每个 Skill 作为 MCP 资源提供。
• 支持：向你的 Agent 提问；它会通过 feedback_submit 提交反馈，并通过 feedback_status 跟进。
• 当前客户端版本

此处包含的内容

src/ 存放服务的 TypeScript 和 JavaScript 源代码，以及其打包的客户端代码：apps/mcp、命令行客户端 apps/product-cli、生成的 REST 客户端 packages/sdk-ts、packages/contracts、packages/workos-auth-contracts 和 packages/agent-skills 中的 Skills。package.json、LICENSE、NOTICE 和 THIRD_PARTY_NOTICES.md 属于此软件包自身。此处未复制构建后的 dist/ 包和软件包 README；release.json 列出了它们的 SHA-256 摘要，因此此仓库及这些文件共同构成已发布的 tarball。npm view @amerged/[email protected] dist.integrity 的结果与 release.json 中的 npm.integrity 一致。

许可证

Apache-2.0 适用于 Amerged 客户端代码（LICENSE、NOTICE）。打包在 npm 软件包中的第三方代码仍遵循各自的许可证（THIRD_PARTY_NOTICES.md）。运行项目的托管平台为私有平台，未包含在内；使用该平台须遵守条款。