Servidor MCP de PocketBase

Un servidor MCP en pleno desarrollo, basado en el de Dynamics, que he estado probando y perfeccionando. Este servidor 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).

¿Por qué esto y no DynamicsEndpoints?

Esto se ha probado en la última versión (actualmente la 26.1 de PocketBase) y se basa en las definiciones de tipo del JS-SDK, no en las definiciones arbitrarias e incorrectas de Dynamics. Muchos de los métodos ni siquiera funcionan.

Related MCP server: PocketBase MCP Server

Configurar el servidor MCP localmente (única forma admitida por ahora)

Para configurar el servidor MCP localmente, deberá configurarlo en su archivo cline_mcp_settings.json o en cualquier otro que utilice (claude, cursor, la configuración es idéntica, solo necesita encontrar dónde está almacenada). Así es como se hace:

1. Localice el archivo cline_mcp_settings.json : Este archivo suele estar en el directorio de configuración de usuario de Cursor. Por ejemplo: /Users/yourusername/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Configurar el servidor: Añada una nueva entrada al objeto mcpServers en el archivo cline_mcp_settings.json . La clave debe ser un nombre único para el servidor (p. ej., "pocketbase-server") y el valor debe ser un objeto que contenga la configuración del servidor.

   {
     "mcpServers": {
       "pocketbase-server": {
         "command": "node",
         "args": [
           "build/index.js"
         ],
         "env": {
           "POCKETBASE_URL": "http://127.0.0.1:8090",
           "POCKETBASE_ADMIN_EMAIL": "admin@example.com",
           "POCKETBASE_ADMIN_PASSWORD": "admin_password"
         },
         "disabled": false,
         "autoApprove": [
           "create_record",
           "create_collection"
         ]
       }
     }
   }

   • command : El comando para iniciar el servidor (normalmente node ).

   • args : Una matriz de argumentos para pasar al comando. Debe apuntar al archivo JavaScript compilado de su servidor MCP (p. ej., build/index.js ). Asegúrese de que la ruta sea correcta.

   • env : Un objeto que contiene variables de entorno.

     • POCKETBASE_URL : La URL de su instancia de PocketBase. Es obligatoria .

     • POCKETBASE_ADMIN_EMAIL : el correo electrónico de administrador para su instancia de PocketBase (opcional, pero necesario para algunas operaciones).

     • POCKETBASE_ADMIN_PASSWORD : La contraseña de administrador para su instancia de PocketBase (opcional, pero necesaria para algunas operaciones).

   • disabled : si desea deshabilitar el servidor al iniciarse.

   • autoApprove : lista de herramientas para aprobar automáticamente.

   • Ajuste los valores en el objeto env para que coincidan con la configuración de su instancia de PocketBase.

3. Iniciar el servidor: después de configurar el archivo cline_mcp_settings.json , puede comenzar a utilizar el servidor MCP con las herramientas configuradas.

Características

Gestión de cobros

• Crear y administrar colecciones con esquemas personalizados

• Recuperar esquemas de colección y metadatos

Operaciones de registro

• Operaciones CRUD para registros

• 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

Operaciones de base de datos

• Copia de seguridad de la base de datos

Herramientas disponibles

Gestión de cobros

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

• get_collection : Obtener detalles del esquema para una 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

Gestión de usuarios

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

• create_user : Crea una nueva cuenta de usuario

Operaciones de base de datos

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

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

// 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
    }
  ]
});

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

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