Hostsmith

@hostsmith/mcp-server

面向 Hostsmith 托管平台的官方 Model Context Protocol 服务。

面向 Agent 的静态托管——提供文件，即可获得在线 URL。 Claude Code 可以发布 HTML 报告。Cursor 可以预览生成的演示。Claude 可以从 claude.ai 或 Desktop 发布单页网站。一次 MCP 调用 → 几秒内获得公开 HTTPS URL。无需代码仓库、CI 或构建步骤。支持自定义域名、私有站点以及欧盟或美国数据驻留。

为什么选择 Hostsmith

• 以交付物为先。 无需代码仓库或构建配置——放入文件（或让 Agent 生成文件），即可获得 URL。
• 专为 Agent 打造。 原生支持 MCP、基于 OAuth 的权限范围，以及可供 Agent 串联调用的结构化工具描述。
• 支持欧盟或美国数据驻留。 从架构层面选择用户数据的存储位置，而不是通过复选框设置。

工具

工具	描述
list_sites	列出账户在指定数据分区中的所有站点
get_site	获取特定站点的详细信息
create_site	创建新站点
delete_site	删除站点
list_domains	列出可用域名（共享域名和自定义域名）
get_account	获取账户信息、订阅方案和使用情况
deploy_files	将内联文件内容部署到站点
deploy_create_upload	开始直接上传二进制文件或大型文件
deploy_finalize	提交通过 deploy_create_upload 开始的部署

使用方法

通过 OAuth 2.0 进行身份验证。不支持静态访问令牌。

Claude（claude.ai、Desktop、Cowork、mobile）

只需将 Hostsmith 添加为自定义连接器一次，即可在你账户中的所有 Claude 应用中使用。

1. 在 Claude 中，打开 Customize > Connectors，点击 + Add，然后点击 Add custom connector。

2. 将 Hostsmith 设为名称，并粘贴 MCP 服务 URL：

   https://mcp.hostsmith.net/mcp
   

3. 点击 Continue，完成连接器添加，然后连接它。Claude 会在浏览器中打开 Hostsmith，以便针对你的 Hostsmith 账户授权该连接器。

Claude 免费套餐允许添加一个自定义连接器。在 Team 和 Enterprise 套餐中，所有者需在 Organization settings > Connectors 下添加连接器；之后，每位成员都需点击 Customize > Connectors 下 Hostsmith 旁边的 Connect，并使用自己的 Hostsmith 账户登录。

Claude 会在每次工具调用前征求你的批准。若要更改此设置，请在 Customize > Connectors 下打开 Hostsmith，并设置其 Tool permissions。

若要撤销授权，请在 Customize > Connectors 下打开 Hostsmith，点击 ⋯，然后点击 Remove（Team 和 Enterprise 套餐的所有者：前往 Organization settings > Connectors）。若要强制重新授权，请点击 Disconnect，然后点击 Connect。

Stdio（Claude Code、Cursor、Cline、Windsurf、Zed）

将此条目添加到 MCP 客户端的配置中：

{
  "mcpServers": {
    "hostsmith": {
      "command": "npx",
      "args": ["-y", "@hostsmith/mcp-server"]
    }
  }
}

首次调用工具时，浏览器中会触发 OAuth 流程，以针对你的 Hostsmith 账户授权该服务。

远程 URL（其他客户端）

任何支持远程 Streamable HTTP 传输的 MCP 客户端都可以直接连接到托管服务：

{
  "mcpServers": {
    "hostsmith": {
      "url": "https://mcp.hostsmith.net/mcp"
    }
  }
}

客户端会自动处理 OAuth 流程——你将被重定向到 Hostsmith 以授权访问。

Claude Code 也可以直接使用托管服务：

claude mcp add --transport http hostsmith https://mcp.hostsmith.net/mcp

Cursor（一键安装）

点击徽章，将远程 Hostsmith 服务（https://mcp.hostsmith.net/mcp）添加到 Cursor。首次调用工具时，浏览器中会触发 OAuth 流程。

本地 HTTP（可自托管）

以 HTTP 模式运行服务，并让 MCP 客户端通过它执行 OAuth 授权：

npx @hostsmith/mcp-server http

{
  "mcpServers": {
    "hostsmith": {
      "url": "http://localhost:3100/mcp"
    }
  }
}

嵌入 HTTP 处理器

createFetchHandler 会返回一个符合 Web 标准的 (req: Request) => Promise<Response> 处理器，可用于在你自己的运行时（例如 Lambda、边缘 Worker 或 Node 服务）中托管服务。它不会读取环境变量；请传入配置：

import { createFetchHandler } from "@hostsmith/mcp-server";

const handler = createFetchHandler({
  hostsmithUrl: "https://hostsmith.net",
  mcpBaseUrl: "https://mcp.example.com",
  // Optional: called for every authenticated MCP request with that
  // request's new McpServer and the access token's decoded claims,
  // before the server handles the request.
  onServer: async (server, { claims }) => {
    // e.g. attach your own instrumentation to `server`
  },
});

onServer 会被等待执行。若它抛出错误，错误会被记录下来，请求则会按没有钩子的情况处理。声明内容会被解码，但不会经过验证；Hostsmith API 会在每次工具调用时验证令牌。Hostsmith 在 mcp.hostsmith.net 上托管的服务会使用此钩子进行使用情况分析。该软件包本身不包含分析客户端，也不会发送遥测数据；CLI 不会传入钩子。

环境变量

变量	默认值	描述
HOSTSMITH_URL	https://hostsmith.net	Hostsmith 应用 URL（OAuth 端点）。
HOSTSMITH_API_DOMAIN	-	覆盖两个分区使用的上游 API 域名。服务会在你设置的值前添加 us.api. 和 eu.api.。例如，HOSTSMITH_API_DOMAIN=staging.example.com 会将调用路由到 https://us.api.staging.example.com 和 https://eu.api.staging.example.com。可用此设置指向暂存或代理 API 主机。
HOSTSMITH_BASE_URL	-	使用单个固定值覆盖 API 基础 URL，完全绕过分区选择。
PORT	3100	HTTP 服务端口。
MCP_BASE_URL	http://localhost:$PORT	MCP 服务的公开 URL，用于 OAuth 元数据。

网络访问

MCP 传输和 OAuth 流程在客户端的应用进程中运行，无需配置 Agent 沙箱——如果你的 MCP 客户端已连接，这些路径就已正常工作。

沙箱环境中的 Agent 最常遇到问题的环节，是 deploy_create_upload + deploy_finalize 期间的 上传 PUT：字节数据会从 Agent 的 shell 发送到分区 API 主机。请在 Agent 终端中允许通过 HTTPS（端口 443）向以下地址发起出站连接：

• us.api.hostsmith.net（适用于 us 分区中的站点）
• eu.api.hostsmith.net（适用于 eu 分区中的站点）

沙箱专用配置示例（Cursor sandbox.json、Claude Code settings.json、Codex config.toml、通用防火墙指南）请参阅网络访问文档。

服务自身对 Hostsmith API 的调用会使用以下标识：User-Agent: hostsmith-mcp-server/<version> hostsmith-js-sdk/<version>。

故障排除

• 工具调用返回 401：OAuth 会话已过期。请从 MCP 客户端重新连接并重新授权。
• OAuth 重定向循环：确认 MCP_BASE_URL 与 MCP 客户端用于访问服务的 URL 一致。
• 分区错误：工具调用接受显式的 partition 参数；如果省略，系统会根据访问令牌推断分区。
• 上传 PUT 失败（DNS、连接被拒绝、代理、超时）：Agent 的 Shell 无法访问分区 API 主机。请参阅网络访问。
• 检查安装情况：运行 npx @modelcontextprotocol/inspector npx -y @hostsmith/mcp-server http，以交互方式浏览工具。

文档

更深入的资料请参阅 hostsmith.net/docs/mcp。

参与贡献

请参阅 CONTRIBUTING.md（包括发布部分，了解版本标记流程）。安全问题：请参阅 SECURITY.md。

许可证

MIT