keithah-hostex-mcp

hostex-mcp

Hostex の物件管理 API 用の Model Context Protocol サーバーです。Claude やその他の MCP クライアントを通じて、バケーションレンタル物件、予約、ゲストとのやり取りなどを管理できます。

hostex-ts を基盤として構築されています。これは Hostex API v3.0.0 用の TypeScript クライアントライブラリです。

特長

• 🏠 物件 - 物件と部屋タイプの管理
• 📅 予約 - CRUD 操作、カスタムフィールド、ロックコード
• 📊 空室状況 - 物件の空室状況カレンダー
• 📋 リスティング - チャネルリスティング、料金、在庫
• 💬 メッセージング - ゲストとのコミュニケーションとメッセージング
• ⭐ レビュー - レビューの管理と返信
• 🔗 ウェブフック - リアルタイムのイベント通知
• ⚙️ ユーティリティ - カスタムチャネルと収入方法

利用可能なツール（25 以上）

• hostex_list_properties - すべての物件を一覧表示
• hostex_list_room_types - 部屋タイプを一覧表示
• hostex_list_reservations - 予約を検索して絞り込む
• hostex_create_reservation - 直接予約を作成
• hostex_cancel_reservation - 予約をキャンセル
• hostex_update_lock_code - 滞在時のロックコードを更新
• hostex_get_custom_fields - カスタムフィールドの値を取得
• hostex_update_custom_fields - カスタムフィールドを更新
• hostex_list_availabilities - 物件の空室状況を確認
• hostex_update_availabilities - 日付をブロック／オープンにする
• hostex_list_conversations - ゲストとの会話を一覧表示
• hostex_get_conversation - 会話の詳細を取得
• hostex_send_message - ゲストにメッセージを送信
• hostex_list_reviews - レビューを検索
• hostex_create_review - レビューまたは返信を投稿
• hostex_list_webhooks - 設定済みのウェブフックを一覧表示
• hostex_create_webhook - 新しいウェブフックを登録
• hostex_delete_webhook - ウェブフックを削除
• hostex_get_listing_calendar - リスティングのカレンダーを取得
• hostex_update_listing_prices - チャネル料金を更新
• hostex_list_custom_channels - カスタムチャネルを一覧表示
• hostex_list_income_methods - 収入方法を一覧表示

インストール

オプション 1：Smithery 経由（推奨）

Smithery から直接インストールします。

npx -y @smithery/cli install @keithah/hostex-mcp --client claude

または、ホストされているサーバー URL を MCP クライアントに追加します。

https://server.smithery.ai/@keithah/hostex-mcp/mcp

プロンプトが表示されたら、Hostex API アクセストークンを入力してください。

オプション 2：MCPB パッケージ

1. Releases から最新の .mcpb ファイルをダウンロードします
2. ファイルをダブルクリックして MCP クライアントにインストールします
3. プロンプトが表示されたら Hostex API トークンを設定します

オプション 3：手動インストール（Claude Desktop）

Claude Desktop の設定（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Linux では ~/.config/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "hostex": {
      "command": "npx",
      "args": ["-y", "hostex-mcp"],
      "env": {
        "HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
      }
    }
  }
}

または、Smithery のホストサーバーを使用します。

{
  "mcpServers": {
    "hostex": {
      "url": "https://server.smithery.ai/@keithah/hostex-mcp/mcp",
      "env": {
        "HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
      }
    }
  }
}

設定

Hostex API アクセストークンが必要です。https://www.hostex.io/ の Hostex アカウント設定から取得してください。

サーバーは configSchema を通じて次の設定を受け付けます。

• accessToken（必須）：Hostex API アクセストークン

使用例

インストール後、Claude に次のような自然言語の質問をできます。

• 「Hostex のすべての物件を表示して」
• 「今週チェックインする予約を一覧表示して」
• 「来週末、物件 12345 をブロックして」
• 「会話 ABC123 のゲストにウェルカムメッセージを送って」
• 「今月受け取ったレビューを教えて」
• 「物件 XYZ の直接予約を作成して」

開発

前提条件

• Node.js >= 18
• npm

セットアップ

# Clone the repository
git clone https://github.com/keithah/hostex-mcp.git
cd hostex-mcp

# Install dependencies
npm install

# Build for stdio transport
npm run build:stdio

# Build for streamable HTTP transport
npm run build:shttp

# Build both transports
npm run build:all

ローカルでのテスト

# Start dev server with Smithery
npm run dev

アーキテクチャ

この MCP サーバーでは、次のものを使用しています。

• @modelcontextprotocol/sdk - MCP プロトコルの実装
• @smithery/sdk - 複数のトランスポートへの対応
• hostex-ts - Hostex API クライアントライブラリ
• zod - スキーマ検証

トランスポート

サーバーは、次の 2 つのトランスポートプロトコルに対応しています。

• stdio - 標準入力／出力（Claude Desktop などのローカル MCP クライアント向け）
• shttp - ストリーマブル HTTP（リモート／ウェブベースの MCP クライアント向け）

どちらも、複数のトランスポートにシームレスに対応するために Smithery を使用して構築されています。

自動更新

このリポジトリには、次の処理を行う GitHub Actions ワークフローが含まれています。

1. 毎時、npm 上の hostex-ts の新しいリリースを確認します
2. 依存関係を更新する PR を自動的に作成します
3. パッチバージョンを更新します
4. MCP バンドルを再ビルドします

PR をマージして新しいリリースタグを作成すると、MCPB パッケージが自動的にビルドされ、GitHub リリースに添付されます。

要件

• Node.js >= 18
• MCP 対応クライアント（Claude Desktop v0.10.0 以降、または任意の MCP クライアント）
• API にアクセスできる Hostex アカウント

ドキュメント

• Hostex API ドキュメント
• hostex-ts npm パッケージ
• Model Context Protocol

ライセンス

MIT

作者

Keith Hadfield

サポート

• 問題：GitHub Issues
• Hostex API：https://docs.hostex.io/
• MCP ドキュメント：https://modelcontextprotocol.io/

---

注：これは非公式のコミュニティプロジェクトであり、Hostex による公式サポートはありません。