calcom-mcp

FastMCP-сервер Cal.com

⚠️ Отказ от ответственности : этот проект не связан и не одобрен Cal.com. Я независимый разработчик и не имею никакой официальной связи с Cal.com.

Этот проект предоставляет сервер FastMCP для взаимодействия с API Cal.com. Он позволяет моделям изучения языка (LLM) использовать инструменты для подключения к важным функциям Cal.com, таким как управление типами событий и бронирование.

Предпосылки

• Питон 3.8+
• Учетная запись Cal.com и ключ API (v2)

Настраивать

1. Клонируйте репозиторий (если применимо) или загрузите файлы.
   git clone https://github.com/Danielpeter-99/calcom-mcp.git cd calcom-mcp
2. Создать виртуальную среду (рекомендуется):
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. Установить зависимости:
   pip install -r requirements.txt
4. Настройте ключ API Cal.com: Вам нужно установить переменную среды CALCOM_API_KEY . Вы можете получить свой ключ API на странице настроек Cal.com (обычно в разделе «Разработчик» или «Настройки безопасности»).
   • Linux/macOS:
     export CALCOM_API_KEY="your_actual_api_key_here"
     Чтобы сделать его постоянным, добавьте эту строку в файл конфигурации оболочки (например, .bashrc , .zshrc ).
   • Windows (PowerShell):
     $env:CALCOM_API_KEY="your_actual_api_key_here"
     Чтобы сделать его постоянным, вы можете установить его через Свойства системы > Переменные среды.

Запуск сервера

После завершения настройки вы можете запустить сервер FastMCP:

Сервер запустится на localhost:8010, и вы должны увидеть вывод, указывающий на то, что он запущен. Если CALCOM_API_KEY не установлен, будет отображено предупреждение.

Доступные инструменты

В настоящее время сервер предоставляет следующие инструменты для взаимодействия с LLM:

• get_api_status() : Проверка, настроен ли ключ API Cal.com в среде. Возвращает строку, указывающую статус.
• list_event_types() : Извлечь список всех типов событий из Cal.com для аутентифицированной учетной записи. Возвращает словарь со списком типов событий или сообщение об ошибке.
• get_bookings(...) : Получить список бронирований из Cal.com с дополнительными фильтрами (event_type_id, user_id, status, date_from, date_to, limit). Возвращает словарь со списком бронирований или сообщение об ошибке.
• create_booking(...) : создать новое бронирование в Cal.com для определенного типа мероприятия и участника. Требуются такие параметры, как start_time, сведения об участнике и идентификаторы типа мероприятия. Возвращает словарь с подробностями бронирования или сообщение об ошибке.
• list_schedules(...) : Список всех расписаний, доступных аутентифицированному пользователю или для определенного пользователя/команды. Необязательные фильтры: user_id, team_id, limit. Возвращает словарь со списком расписаний или сообщение об ошибке.
• list_teams(...) : Список всех команд, доступных аутентифицированному пользователю. Необязательный фильтр: limit. Возвращает словарь со списком команд или сообщение об ошибке.
• list_users(...) : Список всех пользователей, доступных для аутентифицированной учетной записи. Необязательный фильтр: limit. Возвращает словарь со списком пользователей или сообщение об ошибке.
• list_webhooks(...) : Список всех веб-хуков, настроенных для аутентифицированной учетной записи. Необязательный фильтр: limit. Возвращает словарь со списком веб-хуков или сообщение об ошибке.

Примечание: Все инструменты требуют установки переменной среды CALCOM_API_KEY . Если она не установлена, инструменты вернут структурированное сообщение об ошибке.

Использование инструмента и обработка ошибок

• Все инструменты возвращают либо ответ API (в виде словаря или строки), либо структурированное сообщение об ошибке с подробностями об ошибке.
• Сообщения об ошибках включают тип ошибки, код статуса HTTP (если применимо) и текст ответа от API Cal.com.
• Для достижения наилучших результатов всегда проверяйте наличие ключа error в ответе, прежде чем использовать возвращенные данные.
• Инструменты разработаны так, чтобы быть надежными и предоставлять информативную обратную связь как для успешных, так и для неудачных вызовов API.

Заметки о разработке

• Базовый URL-адрес API Cal.com установлен на https://api.cal.com/v2 .
• Аутентификация в основном выполняется с использованием токена Bearer с CALCOM_API_KEY .
• Инструмент create_booking использует заголовок cal-api-version: 2024-08-13 , как указано в документации Cal.com API v2 для этой конечной точки.
• Обработка ошибок включена в вызовы API для предоставления информативных ответов.

🚀 Создано с

Важное примечание по безопасности

Никогда не закодируйте CALCOM_API_KEY напрямую в исходный код. Всегда используйте переменные среды, как описано в инструкциях по настройке, чтобы сохранить ваш ключ API в безопасности.