DirectStay MCP Server

DirectStay MCP サーバー

DirectStay API と連携するためのツールを提供する MCP（Model Context Protocol）サーバーです。

インストール

この MCP サーバーは、ローカルにインストールせずに npx を使って実行できます。

npx @webdevtoday/ds-mcp-server

設定

Claude Desktop

Claude Desktop の設定に以下を追加してください。

{
  "mcpServers": {
    "directstay": {
      "command": "npx",
      "args": ["-y", "@webdevtoday/ds-mcp-server"],
      "env": {
        "DS_TOKEN": "your_directstay_api_token_here"
      }
    }
  }
}

Claude Desktop の設定を確認するには、次の手順に従います。

1. Claude Desktop を開きます
2. 「設定」→「開発者」→「設定を編集」に進みます

利用可能なツール

この MCP サーバーは、DirectStay API と連携するために以下のツールを提供します。

• get_all_properties - すべての物件の一覧を取得します
• get_property_by_id - 特定の物件の詳細を取得します
• get_property_bookings - 特定の物件のすべての予約を取得します
• create_booking - 新しい予約を作成します
• update_booking_status - 既存の予約のステータスを更新します
• identify_caller - 電話番号に基づいて発信者を特定します
• generate_otp - ワンタイムパスワードを生成します
• verify_otp - ワンタイムパスワードを検証します
• send_message - ユーザーにメッセージを送信します
• create_comparison - 物件の比較を作成します
• submit_conversation_insights - 会話から得られたインサイトを送信します

利用可能なすべてのツールとそのパラメーターの詳細を確認するには、次を実行します。

npx @webdevtoday/ds-mcp-server tools

DirectStay API トークンの取得

この MCP サーバーを使用するには、DirectStay API トークンが必要です。API 認証情報を取得するには、DirectStay にお問い合わせください。

開発

前提条件

• Node.js（v16 以上が必要、v20 以上を推奨）
• npm

ローカル環境のセットアップ

1. リポジトリをクローンします
2. 依存関係をインストールします。

   npm install
   

3. API トークンを含む .env ファイルを作成します。

   DS_TOKEN=your_directstay_api_token_here
   

4. サーバーを実行します。

   node mcpServer.js
   

SSE（Server-Sent Events）を使用した実行

node mcpServer.js --sse

Docker のサポート

Docker でビルドして実行します。

docker build -t ds-mcp-server .
docker run -i --rm -e DS_TOKEN=your_token_here ds-mcp-server

ライセンス

MIT

サポート

この MCP サーバーに関する問題や質問がある場合は、GitHub で issue を作成してください。

DirectStay API のサポートについては、DirectStay に直接お問い合わせください。