dynamic-pocketbase-mcp

Servidor dinámico del Protocolo de Contexto de Modelo (MCP) para PocketBase. Conecta tu cliente de IA una vez y gestiona colecciones y registros en cualquier proyecto de PocketBase utilizando herramientas en tiempo de ejecución.

Por qué este servidor es diferente

Muchos servidores MCP de PocketBase son estáticos: codifican el comportamiento específico de la colección o requieren definiciones de herramientas personalizadas por esquema.

dynamic-pocketbase-mcp es dinámico:

• Utiliza herramientas agnósticas a la colección (list_collections, list_records, create_record, etc.)

• Funciona en colecciones existentes y recién creadas sin necesidad de regenerar el código del servidor

• Expone las colecciones de PocketBase en vivo como recursos MCP

Related MCP server: PocketBase MCP Server

Características

• 18 herramientas MCP para salud, autenticación, colecciones, reglas y registros

• Operaciones de ciclo de vida de colecciones (crear, actualizar, eliminar, inspeccionar)

• CRUD de registros con filtros, ordenamiento, paginación y selección de campos

• Autenticación basada en sesiones mediante herramientas (auth_admin, auth_user, get_auth_status, logout)

• Referencias integradas para el esquema de campos y la sintaxis de reglas

Instalación

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

Configuración en un cliente de IA

Claude Desktop

Añádelo a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Si POCKETBASE_URL no está configurado, el servidor utiliza http://localhost:8090 por defecto.

Uso directo

# 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

Tutorial sencillo: chatea con la IA usando este MCP

Después de configurar tu cliente MCP, abre un chat y prueba prompts como estos:

1. "Establece la URL de PocketBase en https://pb.example.com."

2. "Comprueba el estado de salud de mi servidor PocketBase."

3. "Lista todas las colecciones de PocketBase."

4. "Autentícate como administrador con el correo <your-email> y la contraseña <your-password>."

5. "Crea una colección llamada notes con un campo de texto obligatorio title."

6. "Crea un registro en notes con el título First note."

7. "Muestra todos los registros en notes, los más nuevos primero."

8. "Cierra la sesión de autenticación de PocketBase."

Si estos pasos tienen éxito, tu IA ahora puede gestionar el esquema y los datos a través de este servidor MCP.

Flujo de autenticación (mediante herramientas)

1. auth_admin o auth_user

2. get_auth_status

3. logout

Herramientas disponibles

Salud y referencias

• health - Comprobar el estado de salud del servidor PocketBase

• set_base_url - Actualizar la URL de PocketBase para la sesión MCP actual y borrar el token de autenticación

• get_field_schema_reference - Obtener documentación sobre tipos de campos

• get_rules_reference - Obtener referencia de sintaxis de reglas de API

Autenticación

• auth_admin - Autenticarse como administrador/superusuario

• auth_user - Autenticarse como usuario de colección de autenticación (correo/nombre de usuario)

• get_auth_status - Comprobar el estado de autenticación actual

• logout - Cerrar la sesión de autenticación

Colecciones

• list_collections - Listar todas las colecciones

• view_collection - Ver colección por nombre o ID

• create_collection - Crear nueva colección (añade automáticamente los campos de fecha created y updated para colecciones base/auth a menos que se proporcionen)

• update_collection - Actualizar esquema/configuración de la colección

• delete_collection - Eliminar colección

• update_collection_rules - Actualizar reglas de control de acceso

Registros

• list_records - Listar/buscar registros con filtrado, ordenamiento y paginación

• view_record - Ver un solo registro por ID

• create_record - Crear nuevo registro

• update_record - Actualizar registro existente

• delete_record - Eliminar registro

Desarrollo

# 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

Variables de entorno

Licencia

MIT