Hostsmith

@hostsmith/mcp-server

Hostsmith ホスティングプラットフォーム向けの公式 Model Context Protocol サーバーです。

エージェント向けの静的ホスティング — ファイルを渡すだけで、公開URLが手に入ります。 Claude CodeでHTMLレポートを公開。Cursorで生成したデモをプレビュー。claude.aiやDesktopからClaudeで1ページのサイトを公開。MCPを1回呼び出すだけで、数秒で公開HTTPS URLが手に入ります。リポジトリも、CIも、ビルド手順も不要です。カスタムドメイン、プライベートサイト、EUまたはUSのデータレジデンシーに対応しています。

Hostsmithを選ぶ理由

• 成果物を最優先。 リポジトリもビルド設定も不要です。ファイルを配置する（またはエージェントに生成させる）だけで、URLが手に入ります。
• エージェント向けに構築。 MCPネイティブで、OAuthスコープに対応し、エージェントが連鎖して呼び出せる構造化されたツール説明を備えています。
• EUまたはUSのデータレジデンシー。 チェックボックスではなく、アーキテクチャレベルでユーザーのデータの保存場所を選択できます。

ツール

ツール	説明
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、モバイル）

カスタムコネクターとして Hostsmith を一度追加すれば、お使いのアカウントのすべての Claude アプリで利用できます。

1. Claude で カスタマイズ > コネクター を開き、+ 追加 をクリックしてから、カスタムコネクターを追加 を選択します。

2. 名前に Hostsmith と入力し、MCP サーバーの URL を貼り付けます。

   https://mcp.hostsmith.net/mcp
   

3. 続行 をクリックしてコネクターの追加を完了し、接続します。Claude はブラウザーで Hostsmith を開き、Hostsmith アカウントに対してコネクターを認証します。

Claude の無料プランでは、カスタムコネクターは 1 つまで追加できます。Team プランと Enterprise プランでは、オーナーが 組織の設定 > コネクター でコネクターを追加し、各メンバーが カスタマイズ > コネクター で Hostsmith の横にある 接続 をクリックして、自分の Hostsmith アカウントでサインインします。

Claude は、ツールを呼び出すたびに承認を求めます。変更するには、カスタマイズ > コネクター で Hostsmith を開き、ツールの権限 を設定します。

アクセスを取り消すには、カスタマイズ > コネクター で Hostsmith を開き、⋯ をクリックしてから 削除 を選択します（Team プランと Enterprise プランのオーナーの場合は 組織の設定 > コネクター）。再認証を強制するには、切断 をクリックしてから 接続 をクリックします。

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 は、サーバーを独自のランタイム（Lambda、エッジワーカー、Node サーバーなど）でホストするための、Web 標準の (req: Request) => Promise<Response> ハンドラーを返します。環境変数は読み取りません。設定を渡してください。

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 は await されます。エラーがスローされると、エラーがログに記録され、フックがない場合と同様にリクエストが処理されます。クレームはデコードされますが、検証はされません。Hostsmith API は各ツール呼び出し時にトークンを検証します。mcp.hostsmith.net にある Hostsmith のホストサーバーでは、このフックを使用して利用状況の分析を行っています。パッケージ自体には分析クライアントが含まれておらず、テレメトリーも送信しません。また、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	OAuth メタデータで使用する MCP サーバーの公開 URL。

ネットワークアクセス

MCP トランスポートと OAuth フローはクライアントのアプリプロセス内で実行されるため、エージェントのサンドボックス設定は不要です。MCP クライアントが接続できている場合、これらの通信経路は機能しています。

サンドボックス化されたエージェントでよく失敗するのは、deploy_create_upload と deploy_finalize の実行中に行われる アップロード PUT です。バイトデータはエージェントのシェルからパーティション API ホストに送信されます。エージェントのターミナルから、次へのアウトバウンド 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、拒否、プロキシ、タイムアウト）：エージェントのシェルからパーティション API ホストに接続できません。ネットワークアクセスを参照してください。
• インストールを確認する：npx @modelcontextprotocol/inspector npx -y @hostsmith/mcp-server http を実行すると、ツールを対話的に確認できます。

ドキュメント

詳細な情報は hostsmith.net/docs/mcp にあります。

コントリビューション

CONTRIBUTING.md を参照してください（バージョンのスタンプ付け手順については Releases セクションも参照してください）。セキュリティに関する問題については、SECURITY.md を参照してください。

ライセンス

MIT