Лучшие MCP-серверы для PocketBase: полный гид по интеграции с AI-агентами в 2026 году

MCP (Model Context Protocol) — это открытый стандарт для подключения AI-агентов к внешним данным и инструментам. С его помощью Claude, Cursor, Windsurf и другие AI-инструменты могут напрямую взаимодействовать с вашей PocketBase: читать и создавать записи, управлять схемой коллекций, работать с пользователями — всё это без копирования данных в чат вручную. PocketBase MCP превращает ваш AI-инструмент в реального помощника по разработке, способного работать с реальными данными вашего приложения.

Что такое MCP и зачем он нужен для PocketBase

Model Context Protocol — это спецификация, разработанная Anthropic, описывающая стандартизированный способ общения между LLM-клиентами (Claude Desktop, Cursor, Windsurf, VS Code с Copilot) и внешними инструментами и данными.

Без MCP: вы копируете данные из PocketBase в чат, объясняете структуру коллекций, просите AI написать запрос — и потом вставляете результат обратно вручную.

С MCP: AI-агент сам видит вашу схему, может делать запросы, создавать тестовые данные, миgrировать коллекции — всё прямо в рамках разговора или рабочего сеанса.

PocketBase — идеальный кандидат для MCP-интеграции: это self-hosted BaaS (Backend as a Service) с SQLite под капотом, REST API и Admin Dashboard. Легко развернуть, легко интегрировать.

Как работает MCP-сервер технически

MCP-сервер — это процесс, который запускается на вашей машине (или в облаке) и предоставляет AI-клиенту набор «инструментов» (tools). Клиент вызывает эти инструменты по протоколу JSON-RPC 2.0 через stdio или HTTP+SSE.

Для PocketBase типичный набор инструментов MCP-сервера включает:

Список и просмотр коллекций (схема)
CRUD-операции с записями (create, read, update, delete)
Фильтрация и пагинация
Управление пользователями и аутентификацией
Миграция схемы (добавление/изменение полей)
Загрузка и управление файлами
Работа с auth providers (OAuth2)

Обзор лучших MCP-серверов для PocketBase

1. mabeldata/pocketbase-mcp

GitHub: github.com/mabeldata/pocketbase-mcp

Один из самых документированных и стабильных проектов в экосистеме. Ориентирован на повседневную работу разработчика с PocketBase через AI-агент.

Что умеет:

Получение списка коллекций и их схемы
Полный CRUD с поддержкой фильтров в синтаксисе PocketBase
Управление файлами внутри записей
Базовое управление пользователями
Система управления миграциями схемы

Подходит для: разработчиков, которым нужен надёжный инструмент для работы с данными в Claude Desktop или Cursor без лишних сложностей.

Конфигурация для Claude Desktop (mcp_settings.json):

{
  "mcpServers": {
    "pocketbase": {
      "command": "node",
      "args": ["/path/to/pocketbase-mcp/dist/index.js"],
      "env": {
        "POCKETBASE_URL": "http://127.0.0.1:8090",
        "POCKETBASE_ADMIN_EMAIL": "admin@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your-admin-password"
      }
    }
  }
}

Установка:

git clone https://github.com/mabeldata/pocketbase-mcp
cd pocketbase-mcp
npm install
npm run build

2. DynamicEndpoints/pocketbase-mcp-server

GitHub: github.com/DynamicEndpoints/pocketbase-mcp-server

Продвинутая реализация с фокусом на комплексную работу со схемой и данными. Позиционируется как enterprise-вариант для глубокой интеграции AI-агентов в разработку PocketBase-приложений.

Что умеет:

Всё из базового набора
Расширенное управление схемой: добавление, изменение, удаление полей и коллекций
Пакетные операции (batch create/update)
Сложные фильтры и сортировки
Управление relation-полями
Работа с auth providers

Подходит для: команд, активно использующих AI-агентов в разработке, когда нужна не только работа с данными, но и управление структурой приложения.

3. minhdtb/pocketbase-cursor-mcp

GitHub: github.com/minhdtb/pocketbase-cursor-mcp

Специализированная реализация, оптимизированная для работы с Cursor IDE. Фокус — на помощи AI при разработке: генерация TypeScript-интерфейсов из коллекций PocketBase, работа со схемой в контексте кодовой базы.

Что умеет:

Генерация TypeScript-типов из схемы коллекций
CRUD-операции с контекстом текущего проекта
Инспекция схемы для генерации кода
Интеграция с TypeScript SDK PocketBase

Подходит для: разработчиков на TypeScript, использующих Cursor, которым нужно чтобы AI «понимал» типы данных PocketBase при написании кода.

4. iflow-mcp/pocketbase-server (Serverless вариант)

npm: pocketbase-mcp (iflow-mcp)

Единственный в списке вариант с поддержкой Cloudflare Workers и Durable Objects. Если вам нужно развернуть MCP-сервер не локально, а в облаке (например, чтобы несколько членов команды подключались к одному серверу) — это единственный зрелый вариант.

Что умеет:

Полный CRUD с реальным PocketBase
WebSocket поддержка для real-time операций
Stateful сессии через Durable Objects
Деплой на Cloudflare Workers без сервера

Подходит для: команд, которым нужен общий MCP-сервер в облаке, а не локальный на каждой машине.

Сравнительная таблица

| Параметр | mabeldata | DynamicEndpoints | minhdtb | iflow-mcp | |---|---|---|---|---| | CRUD операции | Да | Да | Да | Да | | Управление схемой | Базовое | Расширенное | Базовое | Базовое | | TypeScript генерация | Нет | Нет | Да | Нет | | Batch операции | Нет | Да | Нет | Нет | | Cloudflare Workers | Нет | Нет | Нет | Да | | Auth/OAuth2 | Базовое | Полное | Нет | Базовое | | Качество документации | Высокое | Среднее | Среднее | Среднее | | Активность (2026) | Высокая | Средняя | Средняя | Средняя |

Как установить и настроить за 10 минут

Шаг 1: Убедитесь, что PocketBase запущен

# Скачайте PocketBase с pocketbase.io
# Запустите
./pocketbase serve
# Admin UI доступен на http://127.0.0.1:8090/_/

Шаг 2: Установите MCP-сервер

# Через npm (универсальный способ для mabeldata)
npm install -g pocketbase-mcp

# Или клонируйте репозиторий
git clone https://github.com/mabeldata/pocketbase-mcp
cd pocketbase-mcp && npm install && npm run build

Шаг 3: Настройте MCP-клиент

Для Claude Desktop (файл ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows):

{
  "mcpServers": {
    "pocketbase": {
      "command": "node",
      "args": ["путь/до/pocketbase-mcp/dist/index.js"],
      "env": {
        "POCKETBASE_URL": "http://127.0.0.1:8090",
        "POCKETBASE_ADMIN_EMAIL": "admin@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your-secure-password"
      }
    }
  }
}

Для Cursor (файл .cursor/mcp.json в корне проекта или глобально):

{
  "mcpServers": {
    "pocketbase": {
      "command": "node",
      "args": ["путь/до/pocketbase-mcp/dist/index.js"],
      "env": {
        "POCKETBASE_URL": "http://127.0.0.1:8090",
        "POCKETBASE_ADMIN_EMAIL": "admin@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your-secure-password"
      }
    }
  }
}

Шаг 4: Перезапустите AI-клиент

После изменения конфигурации перезапустите Claude Desktop или Cursor. В интерфейсе должен появиться индикатор подключённых MCP-серверов (обычно иконка с молотком или значок инструментов).

Безопасность: критически важные правила

MCP-сервер с admin-правами даёт AI-агенту полный доступ ко всем данным и конфигурации PocketBase. Несколько обязательных правил:

Никогда не используйте production-учётные данные для dev-разработки. Создайте отдельный тестовый инстанс PocketBase с копией структуры (но не реальных данных пользователей).

Не храните учётные данные в файлах конфигурации репозитория. Используйте .env файлы и добавьте их в .gitignore. Для claude_desktop_config.json — держите его вне репозитория.

Ограничивайте права при возможности. Если вашему сценарию нужен только read-only доступ — создайте в PocketBase API-ключ с минимальными правами.

Используйте autoApprove осторожно. В некоторых MCP-клиентах можно настроить автоматическое подтверждение операций. Для деструктивных действий (delete, schema change) всегда требуйте ручного подтверждения.

{
  "mcpServers": {
    "pocketbase": {
      "command": "node",
      "args": ["..."],
      "env": { "...": "..." },
      "autoApprove": ["list_collections", "get_records"],
      "disabled": false
    }
  }
}

Практические сценарии использования

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

Просите Claude: «Создай 50 тестовых пользователей с реалистичными данными в коллекции users». Агент использует MCP-сервер для последовательных вставок с разными именами, email и датами.

Инспекция и документирование схемы

«Посмотри на схему всех коллекций и создай ER-диаграмму в Mermaid». Агент получает схему через MCP, анализирует связи и генерирует диаграмму.

Отладка данных

«Найди все записи в коллекции orders, где поле status не 'completed' и дата создания старше 7 дней». Агент делает запрос и показывает результат.

Помощь с миграцией схемы

«Добавь поле phone типа text в коллекцию users и сделай его необязательным». Агент выполняет изменение схемы через MCP-сервер.

Резервное копирование PocketBase

PocketBase хранит все данные в одном SQLite-файле — это одновременно преимущество (простота) и риск (один файл = одна точка отказа). При активном использовании MCP-агентов, которые могут вносить изменения в данные и схему, резервное копирование становится ещё важнее.

Сервис dbsend.ru поддерживает SQLite-бэкапы: автоматический дамп файла PocketBase с выгрузкой в облако по расписанию — одна строка конфигурации, никаких bash-скриптов. Особенно актуально для production-инстансов с MCP-доступом, где AI-агент теоретически может изменить данные.

FAQ

Что такое MCP и зачем он нужен?

Model Context Protocol — открытый стандарт для подключения AI-агентов к инструментам и данным. MCP-сервер для PocketBase позволяет AI напрямую работать с вашей базой данных: читать, создавать и редактировать данные, управлять схемой — без ручного копирования в чат.

Безопасно ли давать AI-агенту доступ к базе данных?

При правильной настройке — да. Используйте тестовую копию БД для разработки, ограничивайте права, не используйте production-данные. Для продакшена создайте отдельный read-only пользователь.

Можно ли использовать один MCP-сервер для всей команды?

Да, варианты с поддержкой Cloudflare Workers (например, iflow-mcp) позволяют развернуть MCP-сервер в облаке. Все члены команды подключаются к одному централизованному серверу.

Нужен ли MCP-сервер для работы с PocketBase в AI?

Нет, без MCP вы также можете работать с PocketBase. Но с MCP AI видит реальную структуру вашей базы и может взаимодействовать с данными без ручного описания схемы в каждом запросе.

Как выбрать между разными MCP-серверами для PocketBase?

Для большинства задач — mabeldata/pocketbase-mcp. Если нужна глубокая работа со схемой — DynamicEndpoints. Если используете Cursor и TypeScript — minhdtb. Если нужен облачный сервер для команды — iflow-mcp.

Работает ли MCP с PocketBase v0.20+?

Зависит от конкретного сервера. Всегда проверяйте в README поддерживаемую версию PocketBase API. Выбирайте серверы с коммитами в 2025-2026 годах.