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.

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

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