开发者 → MCP

为您的 AI 提供的 MCP 服务器

NameOcean 在一个 URL 上运行远程 MCP 服务器。只需连接一次 AI 客户端,它即可使用 64 个工具管理您的 DNS、SSL、应用服务器、邮箱和 webhook。您在浏览器中登录:无需粘贴密钥,无需安装任何软件。

https://nameocean.net/mcp

连接您的客户端

Claude Code

Claude Code
$ claude mcp add --transport http nameocean https://nameocean.net/mcp

然后在 Claude Code 中运行 /mcp,并选择 nameocean 进行登录。

Claude Desktop 和 claude.ai

设置 → 连接器 → 添加自定义连接器。将其命名为 NameOcean,并使用 URL https://nameocean.net/mcp。首次使用时,Claude 会打开 NameOcean 登录页面。

Cursor

~/.cursor/mcp.json
{
  "mcpServers": {
    "nameocean": {"url": "https://nameocean.net/mcp"}
  }
}

VS Code

.vscode/mcp.json
{
  "servers": {
    "nameocean": {"type": "http", "url": "https://nameocean.net/mcp"}
  }
}

OpenCode

~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nameocean": {"type": "remote", "url": "https://nameocean.net/mcp", "enabled": true}
  }
}

使用 CLI

nameocean mcp install 会在您的电脑上查找 Claude Code、Cursor 和 OpenCode,并将服务器添加到每个客户端中。安装 CLI。

不支持浏览器登录的客户端

在请求头中发送 API 密钥:Authorization: Bearer no_live_…。工具的权限将与该密钥的权限范围完全一致,因此仅有 dns:read 权限的密钥只能查看,无法修改。

可以这样提问

  • “将 blog.example.com 指向 203.0.113.10,并开启 SSL。”
  • “为 example.com 设置邮箱:创建 hello@ 邮箱,将 sales@ 转发到我的 Gmail,并检查 DNS。”
  • “将此项目部署到我的服务器,如果无法启动,请显示日志。”
  • “将 example.com 的所有记录迁移到新的服务器 IP。请先给我看一下计划。”
  • “当域名即将到期时,向 https://example.com/hooks 发送 webhook。”

您的 AI 能做什么、不能做什么

  • 它无法注册或续费域名,也无法充值。它只能查询域名是否可注册及价格,并引导您前往 nameocean.net/domains 购买。
  • 创建应用服务器按月计费,因此需要两次调用:第一次返回价格,由 AI 展示给您;第二次只有在您确认后才会执行。使用限定权限的 API 密钥时,还需要具备 billing:write 权限。
  • 邮箱密码和环境变量的值绝不会发送给模型;您可以在控制面板中查看。
  • 执行删除、停止或覆盖操作的工具会被标记为破坏性工具,因此会对此类工具进行确认的客户端会先征求您的同意。
  • 它所做的所有更改都会记录在 控制面板 → 活动 中,并注明执行操作的应用。您可以随时在 控制面板 → 已连接的应用 中断开应用连接。
  • 使用应用连接和 API 密钥前,您的账户需要开启两步登录。

工具

这些描述是供您的 AI 读取的,因此使用英文。 读取 仅读取 · 写入 会更改内容 · 破坏性 删除、停止或覆盖

Account and domains

get_account
读取
Your email, account credit (USD) and how many domains and DNS zones you have.
check_domain
读取
Is a domain available to register, and its register/renew price in USD. Registering is done by the user in the dashboard.
list_activity
读取
The account's activity log, newest first: changes made through the API, the CLI and MCP (by which key or app), refused calls, and API key and app changes. Use it to show the user what was done.
list_domains
读取
Domains registered in your account with expiry, auto-renew and nameservers.
get_domain
读取
One domain: nameservers, lock, auto-renew and SSL status.
update_domain
写入
Turn auto-renew or the transfer lock on or off.
set_nameservers
破坏性
Change a domain's nameservers. Pass 2-4 hostnames, or ["nameocean"] to go back to NameOcean DNS. Moving away from NameOcean DNS stops DNS records, server bindings and email from working.

DNS

list_dns_zones
读取
DNS zones hosted on NameOcean DNS.
create_dns_zone
写入
Host a domain's DNS on NameOcean (free).
list_dns_records
读取
All records of a DNS zone with their type and id.
add_dns_record
写入
Add a DNS record. Fields by type: A {hostname, ip}, CNAME {hostname, target}, MX {hostname, priority, target}, TXT {hostname, text}, SRV {hostname, priority, weight, port, target}, PTR {hostname, target}, REDIRECT {hostname, target URL, save_path}. Changes reach the nameservers within seconds.
update_dns_record
写入
Change fields of an existing record (find its type and id with list_dns_records).
delete_dns_record
破坏性
Delete a DNS record by type and id.
export_dns_zone
读取
The zone as a DNS-as-code file (JSON, records in {name, type, value, ttl} form), without ids. Start from this to change many records at once with plan_dns_zone / apply_dns_zone.
plan_dns_zone
读取
Compare a full list of records with the zone and show what apply_dns_zone would create, change and delete. Changes nothing. Show the plan to the user before applying it.
apply_dns_zone
破坏性
Make the zone match a full list of records, in one transaction (nothing changes when one record is refused). Run plan_dns_zone first, get the user's OK for its deletes, and pass its serial so a zone changed in between is refused.

SSL

get_ssl
读取
SSL certificate status of a zone and its download link.
issue_ssl
写入
Issue a free wildcard Let's Encrypt certificate for a zone on NameOcean DNS.

应用服务器

list_servers
读取
Your app servers with SSH command, git remote, open ports and bound domains.
get_server
读取
One app server in detail.
open_port
写入
Open a port on a server. 80 (behind HTTPS on 443) and SSH are open already; NameOcean assigns the external port.
close_port
破坏性
Close an open port by its id (see get_server).
bind_domain
写入
Serve a domain or subdomain from a server over HTTPS. The domain must use NameOcean DNS; DNS records and the certificate are set up automatically.
unbind_domain
破坏性
Stop serving a domain from a server, by binding id (see get_server).
list_server_plans
读取
App server plans you can create: CPU, memory, disk and monthly price (USD).
create_server
写入
Create an app server; it is billed monthly. First call without confirm to get the price, show it to the user, and call again with confirm: true only after they agree.
start_server
写入
Start a stopped server.
stop_server
破坏性
Stop a server (its sites go down; billing continues). Ask the user first.
restart_server
破坏性
Reboot a server (a short outage). Ask the user first.
list_backups
读取
A server's backups (free, nightly and manual; the last 7 days, at most 7).
backup_server
写入
Start a backup of a server now.
restore_backup
破坏性
Replace EVERYTHING on a server with one of its backups. Can't be undone: get the user's explicit OK for this backup first.
list_apps
读取
Supervisor programs on an app server and whether they run.
restart_apps
写入
Restart every app (supervisor) on a server and reload nginx, e.g. after changing config.
read_logs
读取
The last lines of an app's output (a supervisor program), or nginx / nginx-access.
list_env
读取
Names of a server's env variables (values are secrets and are not shown here).
set_env
写入
Set or remove env variables every app on the server gets, then restart the apps.
add_ssh_key
写入
Let a public SSH key log in to a server as root (needed for git push from a new machine).
list_deploys
读取
The commit a server runs now and its recent deploys.
finish_deploy
写入
After `git push` to the server's git remote: check the commit arrived, restart the apps, reload nginx and record the deploy. Returns each app's state and the output.
get_deploy_guide
读取
How to deploy code to a server: git remote, SSH, layout, ports and supervisor examples.

电子邮件

list_email_domains
读取
Domains with paid NameOcean email hosting: plan, storage, mailbox count, expiry.
get_email_domain
读取
A mail domain's mailboxes, aliases, mailing lists and the IMAP/SMTP settings for mail apps.
check_email_dns
读取
Look up a mail domain's NS, MX, SPF, DKIM and DMARC now and say which differ from what NameOcean mail needs (with the expected values).
create_mailbox
写入
Create a mailbox (username@domain) on a mail domain. A password is generated; it is not returned here, the user reads it in the dashboard. quota_gb comes out of the plan's storage (default 1).
update_mailbox
写入
Change a mailbox's display name or quota (GB).
reset_mailbox_password
写入
Give a mailbox a new generated password. The old one stops working at once (mail apps must be updated); the new one is shown to the user in the dashboard, not returned here. Ask the user first.
delete_mailbox
破坏性
Delete a mailbox with ALL its mail and aliases. Can't be undone: confirm with the user first.
add_email_alias
写入
Deliver another address of the domain to a mailbox (e.g. sales@ to info@).
remove_email_alias
破坏性
Delete an alias of a mail domain.
list_email_forwarding
读取
Free email forwarding: every domain registered in the account, whether forwarding is on, and if it is off, why it can't be turned on.
get_email_forwarding
读取
A domain's forwarding aliases (and whether their targets confirmed) and mail webhooks.
enable_email_forwarding
写入
Turn free email forwarding on for a domain registered at NameOcean: writes its MX record. If the zone has other MX records (another mail provider) this fails unless replace_mx is true, which removes them - ask the user before that.
disable_email_forwarding
破坏性
Turn forwarding off for a domain (removes the MX record; aliases are kept).
add_email_forward
写入
Forward localpart@domain to another address. A new target address gets a confirmation mail; forwarding starts once its owner confirms.
remove_email_forward
破坏性
Stop forwarding localpart@domain.
list_forwarded_mail
读取
Mail a forwarding domain received in the last 30 days: from, subject, status (forwarded, spam, quota, bounced...). Never the body.
send_email
写入
Send an email from one of the user's mailboxes or aliases (a domain with NameOcean email hosting whose SPF and DKIM are set up). Before calling, show the user the from address, the recipients, the subject and the body, and send only after they say yes. Returns one id per recipient; delivery results come later in list_sent_email.
list_sent_email
读取
Mail sent with the API in the last 30 days and what happened to each recipient (queued, delivered, delayed, failed, suppressed), with the SMTP error. Never the body.

Webhooks

list_webhooks
读取
Webhook endpoints that receive this account's events (domain, DNS, SSL), with the event types they want.
create_webhook
写入
Send account events to an https URL. events: types such as dns.record.created, groups such as dns.*, or ["*"]; the event list is at https://nameocean.net/developers/webhooks/. Returns the signing secret.
delete_webhook
破坏性
Stop sending events to a webhook endpoint and delete it.
send_test_event
写入
Post a webhook.test event to an endpoint now and show what it answered.
list_webhook_deliveries
读取
Recent deliveries to a webhook endpoint: event, status, attempts, the receiver's answer.

外部端口

Streamable HTTP,无状态,支持协议版本 2025-11-25、2025-06-18 和 2025-03-26。登录采用 OAuth 2.1,支持 PKCE 和动态客户端注册;服务器元数据位于 /.well-known/oauth-protected-resource。这些工具调用的代码与 REST API 相同,因此所有权校验、权限范围和速率限制也完全一致。