Meet.bot

Meet.bot MCP（Model Context Protocol）

Meet.bot Booking Page API 向けの Model Context Protocol（MCP）サーバーです。AI アシスタントがスケジュール管理や予約機能を利用できるようにします。

これは何ですか？

この MCP サーバーは、AI アシスタント（Claude、ChatGPT など、MCP に対応したもの）をお使いの Meet.bot アカウントに接続し、代わりにミーティングをスケジュールできるようにします。予約リンクを手動でコピーしたり、カレンダーを確認したりする代わりに、AI アシスタントに「来週、John と30分のミーティングをスケジュールして」と頼むだけで、MeetBot のスケジュールページを通じて予約を処理できます。

仕組み：

1. MeetBot API トークンを MCP サーバーに接続します
2. この MCP サーバーを使用するように AI アシスタントを設定します
3. AI アシスタントにミーティングのスケジュールを依頼します。空き状況の確認、時間枠の検索、MeetBot アカウントを通じたミーティングの直接予約ができます

これは、ミーティングのスケジュールを自動化し、AI アシスタントにカレンダーを賢く管理させたい多忙なプロフェッショナルに特に便利です。

アカウントをお持ちでない場合は、https://meet.bot で無料で登録できます。

機能

• 完全な API カバレッジ：Meet.bot Booking Page API v1 のすべてのエンドポイントを実装しています
• 型安全性：包括的な型定義を備えた完全な TypeScript サポート
• 実行時検証：入力検証とデータ整合性のための Zod スキーマ
• 認証サポート：Bearer トークン認証
• エラー処理：詳細なエラーメッセージを備えた堅牢なエラー処理
• ヘルスチェック：/v1/pages エンドポイントを使用したヘルスモニタリングを内蔵
• MCP プロトコル準拠：Model Context Protocol サーバーを完全に実装
• デュアルモード対応：ローカル（stdio）またはリモート（HTTP/SSE）で実行
• 本番環境にデプロイ済み：https://mcp.meet.bot で稼働中
• 本番環境対応：本番環境での使用に向けて、十分にテストおよび検証済み

インストール

npm install @meetbot/mcp

クイックスタート

1. インストールと設定

# Install the package
npm install @meetbot/mcp

# Or install globally for CLI usage
npm install -g @meetbot/mcp

2. 認証

認証はツールではなく、接続に基づいて行われます。

• **HTTP/SSE（リモート。例：https://mcp.meet.bot）**：接続時に、リクエストヘッダーで Authorization: Bearer <your_api_token> を送信します。サーバーはこのトークンをそのセッションのすべての API 呼び出しに使用します。
• Stdio（ローカル）：サーバーの起動時に MEETBOT_AUTH_TOKEN 環境変数を設定します（例：MEETBOT_AUTH_TOKEN=your_token npx @meetbot/mcp）。

configure_meetbot などのツールはありません。AI は以下のツールを使用し、認証は接続によって処理されます。

3. 利用可能なツールを使用する

MCP サーバーでは、次のツールを利用できます。

スケジュールページを取得

await get_scheduling_pages();
// Returns all scheduling pages for the authenticated user

ページ情報を取得

await get_page_info({
  page: "https://meet.bot/user/30min"
});
// Returns detailed information about a specific scheduling page

空き時間枠を取得

await get_available_slots({
  page: "https://meet.bot/user/30min",
  count: 10,
  start: "2025-01-01",
  end: "2025-01-31",
  timezone: "America/New_York",
  booking_link: true
});
// Returns available booking slots with optional filters

ミーティングを予約

await book_meeting({
  page: "https://meet.bot/user/30min",
  guest_email: "[email protected]",
  guest_name: "Jane Doe",
  notes: "Meeting to discuss project requirements",
  start: "2025-01-15T14:00:00Z"
});
// Books a new meeting slot

ヘルスチェック

await health_check();
// Verifies API connectivity using the /v1/pages endpoint

Webhook

ミーティングが予約、再スケジュール、またはキャンセルされた瞬間に通知を受け取れます。Meet.bot は、各イベント（booking_received、booking_rescheduled、booking_cancelled）について、パートナー Webhook と同じ仕様の、JWT 署名付き（HS256）JSON ペイロードをお使いの URL に POST します。

// List your webhooks
await list_webhooks();

// Create (omit id) or update (pass id) a webhook
await set_webhook({
  webhook_url: "https://your-app.example.com/meetbot-hook",
  description: "CRM sync",
  coverage: "all",   // or "selected" with pages: [<page id>, ...]
  scope: "self"      // team admins can use "team" to also receive teammates' bookings
});
// Returns the webhook including the shared secret used to verify the signature.

// Delete a webhook
await delete_webhook({ id: 123 });

デプロイオプション

MCP サーバーは2つのモードで実行できます。

1. ローカルモード（Stdio トランスポート）

Claude Desktop などの AI アシスタントとのローカル連携向けです。通信には stdio トランスポートを使用します。

# Run locally
npx @meetbot/mcp

# Or with environment variable
MEETBOT_AUTH_TOKEN="your_token" npx @meetbot/mcp

2. HTTP モード（SSE トランスポート）

HTTP/SSE トランスポートを使用したリモートデプロイ向けです。これにより、ネットワーク経由で MCP サーバーにアクセスできます。

HTTP サーバーの実行

# Build and start the HTTP server
npm run build
npm run start:http

# Or with custom port
PORT=8080 npm run start:http

# Or run directly with npx
npx meetbot-mcp-http

サーバーエンドポイント

• SSE エンドポイント：GET /sse - MCP 通信用の SSE 接続を確立します
• メッセージエンドポイント：POST /messages?sessionId=<id> - クライアントメッセージを受信します
• ヘルスチェック：GET /health - サーバーのヘルス状態

認証

すべてのリクエストでは、Authorization ヘッダーに Bearer トークンが必要です。

Authorization: Bearer <your-meetbot-api-token>

Meet.bot API の認証にも同じトークンが使用されます。

HTTP サーバーのテスト

ローカルテスト：

# Health check (should fail without auth)
curl http://localhost:3000/health

# Health check with authentication
curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/health

# Connect to SSE endpoint
curl -N -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/sse

# Or use the test script
./test-http-server.sh YOUR_TOKEN

本番環境でのテスト：

# Test the live deployment
curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://mcp.meet.bot/health

# Expected response:
# {"status":"ok","service":"meetbot-mcp"}

デプロイ

HTTP サーバーは、さまざまなプラットフォームにデプロイできます。

• Railway：railway up ✅ https://mcp.meet.bot で稼働中
• Fly.io：fly launch && fly deploy
• Google Cloud Run：コンテナベースのデプロイ
• AWS App Runner：コンテナベースのデプロイ
• 任意の VPS：Node.js で直接実行

例：本番環境への接続

# Your MCP client should connect to:
# https://mcp.meet.bot/sse

# With Authorization header:
# Authorization: Bearer <your-meetbot-api-token>

Dockerfile の例：

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist ./dist
EXPOSE 3000
CMD ["node", "dist/cli-http.js"]

MCP 統合

AI アシスタントでの使用

この MCP サーバーは、Model Context Protocol をサポートする Claude、ChatGPT などの AI アシスタントと統合できます。

設定例

{
  "mcpServers": {
    "meetbot": {
      "command": "npx",
      "args": ["@meetbot/mcp"],
      "env": {
        "MEETBOT_AUTH_TOKEN": "your_bearer_token_here"
      }
    }
  }
}

利用可能な MCP ツール

このサーバーは、AI アシスタント向けに 8 つのツールを公開します。

1. get_scheduling_pages - すべてのスケジュールページを一覧表示
2. get_page_info - ページの詳細を取得
3. get_available_slots - 空いている時間枠を検索
4. book_meeting - ミーティングを予約
5. health_check - /v1/pages エンドポイントを使用して API 接続を確認
6. list_webhooks - 予約に関する送信 Webhook を一覧表示
7. set_webhook - Webhook を作成または更新（booking_received / booking_rescheduled / booking_cancelled）
8. delete_webhook - Webhook を削除

認証は接続によって提供されます（リモート接続では HTTP ヘッダーの Bearer トークン、ローカルの stdio では MEETBOT_AUTH_TOKEN）。独立した設定ツールはありません。

テストと検証

このパッケージは、徹底的にテストおよび検証されています。

✅ MCP プロトコル準拠：JSON-RPC 2.0 を完全にサポート
✅ ツール検出：5 つのツールをすべて適切に公開
✅ エラー処理：適切なエラーレスポンス
✅ 型安全性：TypeScript を完全にサポート
✅ スキーマ検証：Zod による入力検証
✅ 本番環境対応：実際の MCP クライアントでテスト済み

パッケージ統計

• パッケージサイズ：12.8 kB（展開後 58.0 kB）
• テストカバレッジ：21 件のテストに合格
• 依存関係：本番環境用の依存関係が 3 件
• TypeScript：型カバレッジ 100%
• ビルドステータス：✅ 合格
• npm レジストリ：公開済みで利用可能

使用例

ライブラリとして

import { MeetbotClient, MeetbotMCPServer } from '@meetbot/mcp';

// Use as a direct API client
const client = new MeetbotClient({
  authToken: 'your_token'
});

// Use as an MCP server
const server = new MeetbotMCPServer();
await server.run();

MCP サーバーとして

# Run the MCP server
npx @meetbot/mcp

# Or install globally
npm install -g @meetbot/mcp
meetbot-mcp

API リファレンス

MeetbotClient

直接統合するためのコア API クライアントです。

import { MeetbotClient } from '@meetbot/mcp';

const client = new MeetbotClient({
  authToken: 'your_token'
});

// Get all scheduling pages
const pages = await client.getPages();

// Get page information
const pageInfo = await client.getPageInfo({
  page: 'https://meet.bot/user/30min'
});

// Get available slots
const slots = await client.getSlots({
  page: 'https://meet.bot/user/30min',
  count: 20
});

// Book a meeting
const booking = await client.bookSlot({
  page: 'https://meet.bot/user/30min',
  guest_email: '[email protected]',
  guest_name: 'Jane Doe',
  start: '2025-01-15T14:00:00Z'
});

データ型

すべての API レスポンスは完全に型付けされています。

interface BookSlot {
  success: boolean;
  page: string;
  guest_email: string;
  guest_name: string;
  notes?: string;
  start: string;
  ical_uid: string;
}

interface PageInfo {
  title: string;
  duration: number;
  url: string;
  owner_name: string;
  max_days_into_the_future: number;
}

interface Slots {
  count: number;
  duration: number;
  slots: SlotDetails[];
}

設定

環境変数

環境変数を使用して MCP サーバーを設定できます。

export MEETBOT_AUTH_TOKEN="your_bearer_token"

# Then run the server
meetbot-mcp

認証

認証は接続に基づいており、ツールではありません。

• HTTP/SSE：MCP サーバーへの接続時に、リクエストヘッダーで Authorization: Bearer <token> を送信します。
• Stdio：サーバーの実行時に MEETBOT_AUTH_TOKEN を設定します（例：MEETBOT_AUTH_TOKEN=your_token meetbot-mcp）。

開発

テストの実行

npm test
npm run test:watch

リント

npm run lint
npm run lint:fix

CLI の使用方法

このパッケージには、MCP サーバーを実行するためのコマンドラインインターフェイスが含まれています。

# Install globally
npm install -g @meetbot/mcp

# Run the MCP server
meetbot-mcp

# Or run directly with npx (no installation required)
npx @meetbot/mcp

環境変数

環境変数を使用してサーバーを設定できます。

export MEETBOT_AUTH_TOKEN="your_bearer_token"

# Then run the server
meetbot-mcp

エラー処理

MCP サーバーは、よくある問題について詳細なエラーメッセージを提供します。

• 設定エラー：設定パラメーターの不足または無効
• 認証エラー：無効なトークン
• API エラー：Meet.bot API からの詳細なエラーメッセージ
• 検証エラー：フィールドごとの具体的なエラーを伴う入力検証の失敗

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 新しい機能のテストを追加します
5. プルリクエストを送信します

ライセンス

MIT ライセンス - 詳細については LICENSE ファイルを参照してください。

サポート

• ドキュメント：https://docs.meet.bot
• 問題：GitHub Issues
• ディスカッション：GitHub Discussions

変更履歴

1.2.10

• 修正（stdio の起動時クラッシュ）：stdio サーバー（npx @meetbot/mcp）は、tools ケイパビリティを通知せずに tools ハンドラーを宣言していたため、MCP SDK が「Server does not support tools」エラーをスローし、起動時にプロセスが終了していました。capabilities.toolsを宣言するようになり、サーバーは起動してinitializeとtools/listに応答します（情報の参照にトークンは不要です）。

1.2.9

• サーバーカード：検出と手動でのメタデータ参照（ツール、プロンプト、認証）のために/.well-known/mcp/server-card.jsonを追加しました
• Smithery の品質向上：品質スコアリングのために、ツールのアノテーション（audience、priority）、より詳細なパラメーターの説明、プロンプトのケイパビリティを追加しました
• プロンプト（スキル）：Smithery とクライアント向けに、6 つの MCP プロンプト（schedule_meeting、check_availability、book_for_guest、share_booking_link、list_my_pages、suggest_times）を追加し、prompts/listとprompts/getを完全にサポートしました

1.2.7

• 設定例の更新：設定例から不要になったMEETBOT_BASE_URLを削除しました（ベース URL は https://meet.bot にハードコードされています）

1.2.6

• ドキュメントの更新：本番環境の URL を Railway から https://mcp.meet.bot に更新しました
• README の拡充：MCP の目的と、MeetBot アカウントを使ったミーティングのスケジュール方法を説明する「これは何ですか？」セクションを追加しました
• ユーザー登録：無料の Meet.bot アカウントへの登録リンクを追加しました

1.2.5

• Jest の設定：ES モジュールをサポートするように Jest の設定を更新しました
• ビルドの改善：TypeScript のコンパイル対象からテストファイルを除外しました
• 公開：公開チェックリストとドキュメントを改善しました

1.1.1

• ES モジュールの修正：Railway などの Node.js デプロイ環境での ES モジュール互換性を修正しました
• インポート拡張子：すべての相対インポートに適切な.js拡張子を追加しました
• 本番環境へのデプロイ：https://mcp.meet.bot へのデプロイに成功しました
• 本番環境での検証：本番環境で正常に動作することを確認しました

1.1.0

• HTTP/SSE トランスポート：リモートデプロイ向けに SSE トランスポートを備えた HTTP サーバーを追加しました
• Bearer トークン認証：HTTP エンドポイントの認証を実装しました
• マルチモード対応：ローカルの stdio サーバーまたはリモート HTTP サーバーとして実行できます
• デプロイ対応：Railway、Fly.io など向けに Dockerfile とデプロイ設定を追加しました
• ヘルスチェックエンドポイント：監視用の/healthエンドポイントを追加しました
• セッション管理：トランスポートのクリーンアップを含む適切なセッション処理を実装しました
• 本番環境対応：認証とエラー処理を備えた HTTP 実装を完成させました

1.0.4

• ヘルスチェックを修正：ダミーのヘルスチェックエンドポイントではなく、実際の/v1/pagesエンドポイントを使用するようになりました
• ドキュメントの更新：ヘルスチェックの実装についての説明を明確にしました
• 信頼性の向上：ヘルスチェックで API 接続を適切に検証するようになりました

1.0.3

• 設定の簡素化：baseUrl の指定を不要にし、https://meet.bot にハードコードしました
• ドキュメントの更新：設定例を簡素化しました
• ユーザー体験の向上：ユーザーが指定する必要があるのは authToken のみです

1.0.2

• 認証を修正：サポートされていない sessionId パラメーターを削除しました
• API URL の修正：api.meet.bot から meet.bot に更新しました
• ドキュメントの更新：正確な認証例を追加しました

1.0.1

• ドキュメントの拡充：使用例を含む包括的な README を追加しました
• MCP 統合ガイド：AI アシスタントの設定例を追加しました
• テスト結果：検証とテストに関する情報を追加しました

1.0.0

• 初回リリース - Meet.bot API 用の本番環境対応 MCP サーバー
• API を完全にカバー - Meet.bot Booking Page API v1 のすべてのエンドポイントに対応
• TypeScript に対応 - 包括的な型定義による完全な型安全性
• 実行時検証 - 入力検証とデータ整合性のための Zod スキーマ
• MCP サーバーの実装 - Model Context Protocol に完全準拠
• CLI ツール - MCP サーバーを実行するためのコマンドラインインターフェース
• エラー処理 - 詳細なメッセージを備えた堅牢なエラー処理
• 認証 - ベアラートークン認証に対応
• ヘルスチェック - /v1/pages エンドポイントを使用した、組み込みの API 接続監視
• テスト - 21 件のテストに合格した包括的なテストスイート
• ドキュメント - API ドキュメントと使用例を完備
• 機能テスト - 実際の MCP クライアントリクエストで動作を確認
• npm への公開 - npm レジストリへの公開に成功