AgentDomains MCP 服务器

AgentDomains 的 MCP 服务器 —— 为 AI 智能体构建的网站和 API 提供免费域名。它能为任何支持 MCP 的智能体提供一个真实的主机名，位于 makes.fyi 或 agentdomains.co 之下，并提供 DNS 记录、HTTPS、URL 转发和反向代理功能。

有两种运行方式：本地通过 npx 以 stdio 方式运行，或在 https://mcp.agentdomains.co 连接托管的远程端点。

安装（stdio）

无需安装步骤 —— npx 会按需拉取：

AGENTDOMAINS_API_KEY=adom_… npx -y @agentdomains/mcp

Claude Code

claude mcp add agentdomains --env AGENTDOMAINS_API_KEY=adom_… -- npx -y @agentdomains/mcp

Claude Desktop 及其它配置文件型客户端

添加到 claude_desktop_config.json（或你的客户端对应的等效配置文件）中：

{
  "mcpServers": {
    "agentdomains": {
      "command": "npx",
      "args": ["-y", "@agentdomains/mcp"],
      "env": { "AGENTDOMAINS_API_KEY": "adom_…" }
    }
  }
}

Related MCP server: domain-suite-mcp

远程端点

https://mcp.agentdomains.co

通过 Streamable HTTP 传输；使用 POST 发送 JSON-RPC，并在 Authorization 请求头中携带你的密钥：

curl -s https://mcp.agentdomains.co \
  -H 'Authorization: Bearer adom_…' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

在 Claude Code 中：claude mcp add --transport http agentdomains https://mcp.agentdomains.co --header "Authorization: Bearer adom_…"

配置

如果你已经在使用 Go CLI，其 ~/.agentdomains/config.json 会被自动读取，无需设置环境变量。

还没有密钥？调用 signup 工具 —— 它不需要任何凭据，即可生成一个密钥。该密钥只会显示一次，之后永远无法找回，因此请立即保存。账户是临时性的：使用 attach_email 绑定一个邮箱，并在 30 天内确认，否则账户及其域名会被删除。

API 密钥绝不会被记录、打印，也不会出现在任何工具输出中。

工具

每个以标签为作用域的工具都接受一个可选的 domain 参数（默认是 makes.fyi 或 agentdomains.co）。目前没有用于删除单条 DNS 记录的端点。

关于 HTTPS

“帮我搞个 SSL”在这里不是一次单一操作。有两条务实的路径：

• set_proxy —— 边缘使用自己的证书终结 TLS，并将请求代理到你的后端。源站无需安装任何东西。

• add_acme_challenge —— 发布 DNS-01 TXT 记录，以便你自己的 ACME 客户端签发 Let's Encrypt 证书（需要通配符或没有公网 80 端口的主机时可使用）。普通公网 Web 服务器只需使用 HTTP-01，完全不需要任何 DNS 记录。

兼容性

任何 MCP 客户端都可以使用。以下是常见客户端的已验证配置方法：

• Claude Code —— claude mcp add（stdio 或 --transport http），如上所示。

• Claude Desktop —— 在 claude_desktop_config.json 中配置 mcpServers 块。

• OpenAI Agents SDK —— 使用 MCPServerStdio(params={"command": "npx", "args": ["-y", "@agentdomains/mcp"]})，或使用 MCPServerStreamableHttp 连接到远程 URL。

• LangChain / LangGraph —— 使用 langchain-mcp-adapters：MultiServerMCPClient({"agentdomains": {"command": "npx", "args": ["-y", "@agentdomains/mcp"], "transport": "stdio"}})。

• CrewAI —— 使用 MCPServerAdapter，配置参数与上面相同的 stdio 参数。

• 其他客户端 —— 将客户端指向基于 stdio 的 npx -y @agentdomains/mcp，或指向基于 Streamable HTTP 的 https://mcp.agentdomains.co。

开发

npm install
npm run build     # tsc -> dist/
npm run smoke     # boots dist/index.js, runs initialize + tools/list over stdio

需要 Node 18+。唯一的运行时依赖是 @modelcontextprotocol/sdk。

相关

• CLI (Go) —— agentdomains 命令

• Agent skill —— Claude Code 插件

• 文档 · HTTP API

License

FSL-1.1-Apache-2.0 —— 参见 LICENSE。与 CLI 的条款相同。