What is Pocketbase Mcp Server

pocketbase-mcp-server is a Model Context Protocol Server designed for PocketBase, built using TypeScript. It provides tools for managing and listing collections within a PocketBase instance.

Use cases

Use cases include listing and managing collections in a PocketBase instance, integrating with other applications that require data access, and debugging MCP server communications using tools like MCP Inspector.

How to use

To use pocketbase-mcp-server, install the dependencies with ‘npm install’, build the server using ‘npm run build’, and configure it with your PocketBase instance details. You can run it with command line arguments or set environment variables for configuration.

Key features

Key features include the ‘pocketbase_list_collections’ tool, which lists all collections from a PocketBase instance in JSON format. It requires the server to be started with appropriate PocketBase configuration.

Where to use

pocketbase-mcp-server can be used in applications that require management of data collections in PocketBase, such as web applications, mobile apps, and backend services that utilize PocketBase for data storage.

pocketbase-mcp-server MCP Server

Model Context Protocol Server for PocketBase

This is a TypeScript-based MCP server that provides:

• Tools for listing PocketBase collections

Features

Tools

• pocketbase_list_collections - List all collections from a PocketBase instance
  • Requires server to be started with PocketBase configuration
  • Returns JSON representation of all collections

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pocketbase-mcp-server": {
      "command": "/path/to/pocketbase-mcp-server/build/index.js --pb-url=http://localhost:8090 [email protected] --pb-admin-password=your-secure-password"
    }
  }
}

PocketBase Configuration

To enable the PocketBase collections tool, you must provide the following configuration either as command line arguments or environment variables:

• --pb-url=<url> or PB_URL - The URL of your PocketBase instance (e.g., http://localhost:8090)
• --pb-admin-email=<email> or PB_ADMIN_EMAIL - Admin email for authentication
• --pb-admin-password=<password> or PB_ADMIN_PASSWORD - Admin password for authentication

If using environment variables, you can set them like this:

export PB_URL=http://localhost:8090
export [email protected]
export PB_ADMIN_PASSWORD=your-secure-password

Example using command line arguments:

node build/index.js --pb-url=http://localhost:8090 [email protected] --pb-admin-password=your-secure-password

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.