MCP 服务器

pocketbase-mcp-server

Enables CRUD operations on PocketBase collections and records, including listing, viewing, creating, updating, and deleting items.

README

PocketBase MCP Server

A Model Context Protocol (MCP) server for interacting with PocketBase databases.

This server allows you to inspect collections and query, create, update, and delete records inside a PocketBase instance.

Installation & Usage

You can use this server directly via npx (recommended) or install it globally.

Option 1: Run via npx

To run the server without installing it locally, configure your MCP client to use:

npx @yhauxell/pocketbase-mcp-server

Option 2: Global Installation

npm install -g @yhauxell/pocketbase-mcp-server

Then run the command:

pocketbase-mcp-server

Configuration for Claude Desktop or MCP Clients

To register the server, add the following to your MCP client settings file (e.g., claude_desktop_config.json):

Using `npx` (Recommended)

Using admin email & password:

{
  "mcpServers": {
    "pocketbase-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yhauxell/pocketbase-mcp-server"],
      "env": {
        "POCKETBASE_URL": "http://127.0.0.1:8090",
        "POCKETBASE_ADMIN_EMAIL": "your_email@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your_password"
      }
    }
  }
}

Using an auth token:

{
  "mcpServers": {
    "pocketbase-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yhauxell/pocketbase-mcp-server"],
      "env": {
        "POCKETBASE_URL": "http://127.0.0.1:8090",
        "POCKETBASE_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Using Local Build (For Development)

If you are developing locally, run npm run build and use:

{
  "mcpServers": {
    "pocketbase-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/pocketbase-mcp-server/dist/index.js"],
      "env": {
        "POCKETBASE_URL": "http://127.0.0.1:8090",
        "POCKETBASE_ADMIN_EMAIL": "your_email@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your_password"
      }
    }
  }
}

Local Setup (Development)

Clone the repository and install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Configure environment variables in a .env file:

POCKETBASE_URL=http://127.0.0.1:8090
POCKETBASE_ADMIN_EMAIL=your_email@example.com
POCKETBASE_ADMIN_PASSWORD=your_password

Available Tools

pb_list_collections: List all collections in the PocketBase database.
pb_get_collection: Get schema details of a specific collection.
pb_list_records: Retrieve paginated, filtered, and sorted records from a collection.
pb_view_record: Retrieve a single record by its ID.
pb_create_record: Create a new record in a collection.
pb_update_record: Update an existing record in a collection.
pb_delete_record: Delete a record from a collection.