MCP PocketBase Server

Server MCP (Model Context Protocol) para interactuar con bases de datos PocketBase.

Características

Este MCP proporciona las siguientes herramientas:

Tools Disponibles

1. list_collections - Lista todas las colecciones de PocketBase
2. get_collection_schema - Obtiene el schema de una colección
3. get_records - Obtiene registros con paginación y filtros
4. get_record - Obtiene un registro específico por ID
5. create_record - Crea un nuevo registro
6. update_record - Actualiza un registro existente
7. delete_record - Elimina un registro
8. search_records - Busca registros por texto en campos específicos

Instalación

cd mcp-pocketbase

# Instalar dependencias
npm install

# Compilar
npm run build

Configuración

Variables de Entorno

Crea un archivo .env en la raíz del proyecto:

# URL de PocketBase
POCKETBASE_URL=http://localhost:8090

# Credenciales de admin (opcional, para colecciones protegidas)
[email protected]
POCKETBASE_ADMIN_PASSWORD=your_password

Uso con Claude Desktop

Windows

Agrega la siguiente configuración en %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "pocketbase": {
      "command": "node",
      "args": ["C:/Desarrollo/sagittapos-v1/mcp-pocketbase/dist/index.js"],
      "env": {
        "POCKETBASE_URL": "http://localhost:8090",
        "POCKETBASE_ADMIN_EMAIL": "[email protected]",
        "POCKETBASE_ADMIN_PASSWORD": "your_password"
      }
    }
  }
}

macOS/Linux

Agrega la siguiente configuración en ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pocketbase": {
      "command": "node",
      "args": ["/path/to/mcp-pocketbase/dist/index.js"],
      "env": {
        "POCKETBASE_URL": "http://localhost:8090",
        "POCKETBASE_ADMIN_EMAIL": "[email protected]",
        "POCKETBASE_ADMIN_PASSWORD": "your_password"
      }
    }
  }
}

Ejemplos de Uso

Listar colecciones

¿Puedes listar todas las colecciones disponibles en PocketBase?

Obtener registros de una colección

Obtén los primeros 10 clientes de la colección customers

Buscar registros

Busca productos con "zapato" en el nombre

Crear un registro

Crea un nuevo cliente con:
- name: Juan Pérez
- email: [email protected]
- phone: 3001234567

Actualizar un registro

Actualiza el cliente con ID abc123 para cambiar su email a [email protected]

Desarrollo

# Modo desarrollo (con hot reload)
npm run dev

# Compilar para producción
npm run build

# Ejecutar producción
npm start

Recursos

El servidor también expone recursos tipo pocketbase://collectionName que pueden ser accedidos directamente.

Ejemplo:

• pocketbase://customers - Accede a todos los clientes
• pocketbase://products - Accede a todos los productos

Licencia

MIT