Servidor MCP PocketBase avanzado

Un servidor MCP integral que proporciona herramientas sofisticadas para interactuar con bases de datos de PocketBase. Este servidor permite operaciones avanzadas de bases de datos, gestión de esquemas y manipulación de datos mediante el Protocolo de Contexto de Modelo (MCP).

Características

Gestión de cobros

• Crear y administrar colecciones con esquemas personalizados

• Migrar esquemas de recopilación con preservación de datos

• Gestión avanzada de índices (crear, eliminar, listar)

• Validación de esquemas y seguridad de tipos

• Recuperar esquemas de colección y metadatos

Operaciones de registro

• Operaciones CRUD para registros

• Consultas avanzadas con filtrado, ordenación y agregación

• Capacidades de importación y exportación por lotes

• Apoyo para la expansión de relaciones

• Paginación y navegación basada en cursor

Gestión de usuarios

• Autenticación de usuarios y gestión de tokens

• Creación y gestión de cuentas de usuario

• Gestión de contraseñas

• Control de acceso basado en roles

• Manejo de sesiones

Operaciones de base de datos

• Copia de seguridad y restauración de bases de datos

• Múltiples formatos de exportación (JSON/CSV)

• Herramientas de migración de datos

• Optimización de índices

• Operaciones por lotes

Related MCP server: PocketBase MCP Server

Herramientas disponibles

Gestión de cobros

• create_collection : Crea una nueva colección con un esquema personalizado

• get_collection_schema : Obtener detalles del esquema para una colección

• migrate_collection : Migrar el esquema de colección con preservación de datos

• manage_indexes : Crea, elimina o enumera índices de colección

Operaciones de registro

• create_record : Crea un nuevo registro en una colección

• list_records : Lista de registros con filtros y paginación opcionales

• update_record : Actualizar un registro existente

• delete_record : Eliminar un registro

• query_collection : consulta avanzada con filtrado, ordenación y agregación

• import_data : Importa datos a una colección con modos de creación, actualización y actualización.

Gestión de usuarios

• authenticate_user : Autenticar un usuario y obtener el token de autenticación

• create_user : Crea una nueva cuenta de usuario

• list_auth_methods : enumera todos los métodos de autenticación disponibles

• authenticate_with_oauth2 : Autenticar un usuario con OAuth2

• authenticate_with_otp : Autenticar un usuario con una contraseña de un solo uso

• auth_refresh : Actualizar el token de autenticación

• request_verification : Solicitar verificación de correo electrónico

• confirm_verification : Confirmar la verificación del correo electrónico con el token

• request_password_reset : Solicitar restablecimiento de contraseña

• confirm_password_reset : Confirmar el restablecimiento de contraseña con token

• request_email_change : Solicitar cambio de correo electrónico

• confirm_email_change : Confirmar el cambio de correo electrónico con el token

• impersonate_user : Suplantar la identidad de otro usuario (solo administrador)

Operaciones de base de datos

• backup_database : Crea una copia de seguridad de la base de datos de PocketBase con opciones de formato

• import_data : Importa datos con varios modos (crear/actualizar/insertar)

Configuración

El servidor requiere las siguientes variables de entorno:

• POCKETBASE_URL : URL de su instancia de PocketBase (por ejemplo, " http://127.0.0.1:8090 ")

Variables de entorno opcionales:

• POCKETBASE_ADMIN_EMAIL : Correo electrónico de administrador para ciertas operaciones

• POCKETBASE_ADMIN_PASSWORD : Contraseña de administrador

• POCKETBASE_DATA_DIR : Ruta del directorio de datos personalizado

Ejemplos de uso

Gestión de cobros

// Create a new collection
await mcp.use_tool("pocketbase", "create_collection", {
  name: "posts",
  schema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    }
  ]
});

// Manage indexes
await mcp.use_tool("pocketbase", "manage_indexes", {
  collection: "posts",
  action: "create",
  index: {
    name: "title_idx",
    fields: ["title"],
    unique: true
  }
});

Consultas avanzadas

// Query with filtering, sorting, and aggregation
await mcp.use_tool("pocketbase", "query_collection", {
  collection: "posts",
  filter: "created >= '2024-01-01'",
  sort: "-created",
  aggregate: {
    totalLikes: "sum(likes)",
    avgRating: "avg(rating)"
  },
  expand: "author,categories"
});

Importación/exportación de datos

// Import data with upsert mode
await mcp.use_tool("pocketbase", "import_data", {
  collection: "posts",
  data: [
    {
      title: "First Post",
      content: "Hello World"
    },
    {
      title: "Second Post",
      content: "More content"
    }
  ],
  mode: "upsert"
});

// Backup database
await mcp.use_tool("pocketbase", "backup_database", {
  format: "json" // or "csv"
});

Migración de esquemas

// Migrate collection schema
await mcp.use_tool("pocketbase", "migrate_collection", {
  collection: "posts",
  newSchema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    },
    {
      name: "tags",
      type: "json",
      required: false
    }
  ],
  dataTransforms: {
    // Optional field transformations during migration
    tags: "JSON.parse(oldTags)"
  }
});

Métodos de autenticación

// List available authentication methods
await mcp.use_tool("pocketbase", "list_auth_methods", {
  collection: "users"
});

// Authenticate with password
await mcp.use_tool("pocketbase", "authenticate_user", {
  email: "user@example.com",
  password: "securepassword",
  collection: "users"
});

// Authenticate with OAuth2
await mcp.use_tool("pocketbase", "authenticate_with_oauth2", {
  provider: "google",
  code: "auth_code_from_provider",
  codeVerifier: "code_verifier_from_pkce",
  redirectUrl: "https://your-app.com/auth/callback",
  collection: "users"
});

// Request password reset
await mcp.use_tool("pocketbase", "request_password_reset", {
  email: "user@example.com",
  collection: "users"
});

// Confirm password reset
await mcp.use_tool("pocketbase", "confirm_password_reset", {
  token: "verification_token",
  password: "new_password",
  passwordConfirm: "new_password",
  collection: "users"
});

// Refresh authentication token
await mcp.use_tool("pocketbase", "auth_refresh", {
  collection: "users"
});

Manejo de errores

Todas las herramientas incluyen un completo sistema de gestión de errores con mensajes detallados. Los errores se tipifican correctamente e incluyen:

• Errores de solicitud no válida

• Errores de autenticación

• Errores de operación de la base de datos

• Errores de validación del esquema

• Errores de red

Seguridad de tipos

El servidor incluye definiciones de TypeScript para todas las operaciones, lo que garantiza la seguridad de tipos al usar las herramientas. El esquema de entrada de cada herramienta está estrictamente tipado y validado.

Mejores prácticas

1. Utilice siempre un manejo de errores adecuado con los bloques try/catch

2. Validar datos antes de realizar operaciones

3. Utilice índices apropiados para un mejor rendimiento de las consultas

4. Realice copias de seguridad periódicas de su base de datos

5. Utilice migraciones para cambios de esquema

6. Siga las mejores prácticas de seguridad para la gestión de usuarios

7. Supervisar y optimizar el rendimiento de la base de datos

Desarrollo

1. Clonar el repositorio

2. Instalar dependencias: npm install

3. Copiar .env.example a .env y configurar

4. Construir: npm run build

5. Inicie su instancia de PocketBase

6. El servidor MCP se conectará automáticamente a su instancia de PocketBase

Instalación mediante herrería

Para instalar PocketBase Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install pocketbase-server --client claude

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción