MCP Cliniko Server

Сервер протокола контекста модели (MCP), обеспечивающий интеграцию с API Cliniko для управления медицинской практикой.

Возможности

Инструменты (Действия)

Управление пациентами
- list_patients - Поиск и список пациентов
- get_patient - Получение пациента по ID
- create_patient - Создание нового пациента
- update_patient - Обновление данных пациента
- delete_patient - Архивация пациента
Управление записями на прием
- list_appointments - Поиск и список записей на прием
- get_appointment - Получение записи на прием по ID
- create_appointment - Бронирование новой записи
- update_appointment - Изменение записи
- cancel_appointment - Отмена записи
- delete_appointment - Удаление записи
- get_available_times - Получение доступного времени специалиста
Управление счетами
- list_invoices - Список и фильтрация счетов
- get_invoice - Получение деталей счета
- create_invoice - Создание нового счета
- update_invoice - Обновление статуса или деталей счета
- delete_invoice - Удаление черновика счета
Позиции счета
- list_invoice_items - Список позиций в счете
- add_invoice_item - Добавление позиции в счет
- update_invoice_item - Изменение позиции счета
- delete_invoice_item - Удаление позиции из счета
Обработка платежей
- list_payments - Список платежей с фильтрацией
- create_payment - Регистрация платежа
- delete_payment - Удаление записи о платеже
Продукты и услуги
- list_products - Список оплачиваемых продуктов/услуг
- get_product - Получение деталей продукта
- create_product - Создание нового продукта/услуги
Настройка налогов
- list_taxes - Список доступных налоговых ставок
- get_tax - Получение деталей налога
Сложные рабочие процессы
- create_invoice_from_appointments - Генерация счетов на основе записей на прием
- bulk_invoice_generation - Массовое создание счетов за период
- list_patient_cases - Список случаев пациента
- list_invoices_for_case - Получение счетов для случая
Вспомогательные инструменты
- list_practitioners - Список всех специалистов
- list_appointment_types - Список типов записей на прием
- list_businesses - Список организаций
Тестовые данные
- generate_test_data - Генерация синтетических данных австралийской системы здравоохранения
- cleanup_test_data - Удаление тестовых пациентов

Ресурсы (Доступ к данным)

patient://{id} - Данные отдельного пациента
patients://list - Все пациенты
appointment://{id} - Отдельная запись на прием
appointments://list - Все записи на прием
appointments://today - Записи на сегодня
practitioners://list - Все специалисты
businesses://list - Все организации
appointment-types://list - Все типы записей на прием
openapi://spec - Спецификация OpenAPI API Cliniko (формат YAML)

Установка

Клонируйте репозиторий:

git clone https://github.com/yourusername/mcp-cliniko.git
cd mcp-cliniko

Установите зависимости:

npm install

Настройте ваш API-ключ Cliniko:

cp .env.example .env
# Edit .env and add your Cliniko API key

Соберите проект:

npm run build

Конфигурация

Переменные окружения

CLINIKO_API_KEY - Ваш API-ключ Cliniko (обязательно)

Получение API-ключа Cliniko

Войдите в свою учетную запись Cliniko
Перейдите в Settings → Integrations → API Keys
Создайте новый API-ключ
Скопируйте ключ в ваш файл .env

Использование

Режим разработки

npm run dev

Промышленный режим

npm start

Тестирование с помощью MCP Inspector

npm run inspect

Интеграция с Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cliniko": {
      "command": "node",
      "args": ["/path/to/mcp-cliniko/dist/index.js"],
      "env": {
        "CLINIKO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Примеры

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

Список пациентов:

{
  "tool": "list_patients",
  "arguments": {
    "q": "Smith",
    "per_page": 10
  }
}

Создание пациента:

{
  "tool": "create_patient",
  "arguments": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone_number": "0412345678",
    "date_of_birth": "1980-01-15",
    "medicare_number": "1234567890"
  }
}

Бронирование записи на прием:

{
  "tool": "create_appointment",
  "arguments": {
    "starts_at": "2024-01-20T10:00:00Z",
    "patient_id": 123,
    "practitioner_id": 456,
    "appointment_type_id": 789,
    "business_id": 101
  }
}

Генерация тестовых данных:

{
  "tool": "generate_test_data",
  "arguments": {
    "num_patients": 5,
    "num_appointments": 10,
    "days_ahead": 7
  }
}

Использование ресурсов

Ресурсы предоставляют доступ к данным Cliniko только для чтения:

patient://123 - Получить пациента с ID 123
patients://list - Список всех пациентов
appointments://today - Получить записи на сегодня

Ограничения API

API Cliniko имеет ограничение в 200 запросов в минуту. Сервер не реализует ограничение частоты запросов внутри себя, поэтому учитывайте этот лимит при выполнении массовых операций.

Обработка ошибок

Сервер использует стандартные соглашения об ошибках HTTP:

400 - Неверный запрос
401 - Неавторизован (проверьте API-ключ)
404 - Ресурс не найден
429 - Превышен лимит запросов
500 - Внутренняя ошибка сервера

Разработка

Структура проекта

mcp-cliniko/
├── src/
│   ├── index.ts              # Main server
│   ├── cliniko-client.ts     # API client
│   ├── types.ts              # TypeScript types
│   ├── tools/                # MCP tools
│   │   ├── patients.ts
│   │   ├── appointments.ts
│   │   └── synthetic-data.ts
│   └── resources/            # MCP resources
│       └── index.ts
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── .env

Сборка

npm run build

Проверка типов

npx tsc --noEmit

Лицензия

MIT

Поддержка

Документация по API Cliniko доступна по адресу: https://docs.api.cliniko.com/

Документация по MCP доступна по адресу: https://modelcontextprotocol.io/

mcp-cliniko