dynamic-pocketbase-mcp

Динамический сервер протокола контекста модели (MCP) для PocketBase. Подключите свой ИИ-клиент один раз, а затем управляйте коллекциями и записями в любом проекте PocketBase с помощью инструментов времени выполнения.

Почему этот сервер отличается

Многие MCP-серверы для PocketBase являются статическими: они жестко задают поведение для конкретных коллекций или требуют определения пользовательских инструментов для каждой схемы.

dynamic-pocketbase-mcp является динамическим:

• Использует инструменты, не зависящие от конкретных коллекций (list_collections, list_records, create_record и т. д.)

• Работает с существующими и вновь созданными коллекциями без необходимости перегенерации кода сервера

• Предоставляет «живые» коллекции PocketBase в качестве ресурсов MCP

Related MCP server: PocketBase MCP Server

Возможности

• 18 инструментов MCP для проверки работоспособности, аутентификации, управления коллекциями, правилами и записями

• Операции жизненного цикла коллекций (создание, обновление, удаление, проверка)

• CRUD-операции с записями с использованием фильтров, сортировки, пагинации и выбора полей

• Аутентификация на основе сессий через инструменты (auth_admin, auth_user, get_auth_status, logout)

• Встроенные справочные материалы по схеме полей и синтаксису правил

Установка

npm install dynamic-pocketbase-mcp
# or
bun install dynamic-pocketbase-mcp

Настройка в ИИ-клиенте

Claude Desktop

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

{
  "mcpServers": {
    "dynamic-pocketbase": {
      "command": "npx",
      "args": ["-y", "dynamic-pocketbase-mcp"]
    }
  }
}

Если POCKETBASE_URL не задан, сервер по умолчанию использует http://localhost:8090.

Прямое использование

# Use default URL (http://localhost:8090)
npx -y dynamic-pocketbase-mcp

# Use custom PocketBase URL
POCKETBASE_URL=https://pb.example.com \
bunx dynamic-pocketbase-mcp

Простой учебник: общение с ИИ с использованием этого MCP

После настройки MCP-клиента откройте чат и попробуйте следующие запросы:

1. "Установи URL PocketBase на https://pb.example.com."

2. "Проверь состояние работоспособности моего сервера PocketBase."

3. "Выведи список всех коллекций PocketBase."

4. "Авторизуйся как администратор с email <your-email> и паролем <your-password>."

5. "Создай коллекцию с именем notes с обязательным текстовым полем title."

6. "Создай запись в notes с заголовком First note."

7. "Покажи все записи в notes, начиная с самых новых."

8. "Выйди из сессии аутентификации PocketBase."

Если эти шаги выполнены успешно, ваш ИИ теперь может управлять схемой и данными через этот MCP-сервер.

Поток аутентификации (через инструменты)

1. auth_admin или auth_user

2. get_auth_status

3. logout

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

Работоспособность и справочные материалы

• health — Проверка состояния работоспособности сервера PocketBase

• set_base_url — Обновление URL PocketBase для текущей сессии MCP и очистка токена аутентификации

• get_field_schema_reference — Получение документации по типам полей

• get_rules_reference — Получение справочника по синтаксису правил API

Аутентификация

• auth_admin — Аутентификация в качестве администратора/суперпользователя

• auth_user — Аутентификация в качестве пользователя коллекции аутентификации (email/имя пользователя)

• get_auth_status — Проверка текущего статуса аутентификации

• logout — Очистка сессии аутентификации

Коллекции

• list_collections — Список всех коллекций

• view_collection — Просмотр коллекции по имени или ID

• create_collection — Создание новой коллекции (автоматически добавляет поля created и updated для базовых/аутентификационных коллекций, если они не предоставлены)

• update_collection — Обновление схемы/настроек коллекции

• delete_collection — Удаление коллекции

• update_collection_rules — Обновление правил контроля доступа

Записи

• list_records — Список/поиск записей с фильтрацией, сортировкой, пагинацией

• view_record — Просмотр отдельной записи по ID

• create_record — Создание новой записи

• update_record — Обновление существующей записи

• delete_record — Удаление записи

Разработка

# Install dependencies
bun install

# Run in development mode
bun run dev

# Type check
bun run typecheck

# Run tests (builds dist first)
bun run test

# Run all checks (typecheck + tests)
bun run check

# Interactive release helper (bump, check, publish, push tag)
bun run release

# Build for production
bun run build

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

Лицензия

MIT