MCP対応クライアント(Claude Desktop, Cursor, Windsurfなど)とBaserow間でシームレスな統合が可能なMCP(Model Context Protocol)サーバーで、自然言語でAIを活用したデータベース運用を実現します。

OST の特徴

-スマート認証: 認証情報またはマニュアルJWT/databaseトークンで自動トークンが更新されます

• ** ワークスペース管理**: Baserow ワークスペースの一覧、作成、管理 -️️データベース操作: ワークスペース内のデータベースを完全に制御
• テーブル管理: フィールド定義でテーブルを作成、リスト、管理
• ** 列のCRUD操作**: 完全な作成、読み、更新、機能の削除
• ** ⚡ バッチ操作**: 行を作成、更新、削除するための効率的なバルク操作
• ** 一貫した高度の Queries**: Pagination、ろ過および分類サポート -自然言語:あなたのデータベースと相互作用するために普通の英語を使う

受託者

• Node.js v22+(nvm経由でインストール)
• MCP 互換クライアント:
• クロードデスクトップ
• カーソル
• ウインドサーフィン
• その他のMCP対応AIエディタ
• Baserowアカウント(ホストまたはクラウド)

️️ インストール

1. リポジトリのクローン:

2.依存関係のインストール:

Baserow MCP Server

An MCP (Model Context Protocol) server that provides seamless integration between MCP-compatible clients (Claude Desktop, Cursor, Windsurf, etc.) and Baserow, enabling AI-powered database operations through natural language.

🚀 Features

• 🔐 Smart Authentication: Automatic token refresh with credentials or manual JWT/database tokens
• 🏢 Workspace Management: List, create, and manage Baserow workspaces
• 🗄️ Database Operations: Full control over databases within workspaces
• 📊 Table Management: Create, list, and manage tables with field definitions
• 📝 Row CRUD Operations: Complete Create, Read, Update, Delete functionality
• ⚡ Batch Operations: Efficient bulk operations for creating, updating, and deleting rows
• 🔍 Advanced Queries: Pagination, filtering, and sorting support
• 💡 Natural Language: Use plain English to interact with your databases

📋 Prerequisites

• Node.js v22+ (install via nvm)
• An MCP-compatible client:
  • Claude Desktop
  • Cursor
  • Windsurf
  • Any other MCP-compatible AI editor
• Baserow account (self-hosted or cloud)

🛠️ Installation

1. Clone the repository:

   git clone https://github.com/ayyazzafar/mcp-baserow.git
   cd mcp-baserow
   

2. Install dependencies:

   npm install
   

3. Configure authentication:

   cp .env.example .env
   

   Edit .env and add your credentials:

   # Recommended: Use credentials for automatic token refresh
   [email protected]
   BASEROW_PASSWORD=your_password
   
   # Optional: Override default API URL for self-hosted instances
   # BASEROW_API_URL=https://your-baserow-instance.com
   

4. Build the project:

   npm run build
   

🔑 Authentication Options

Option 1: Username/Password (Recommended)

Provides automatic token refresh and full API access:

[email protected]
BASEROW_PASSWORD=your_password

Option 2: JWT Token

For manual token management (expires after 60 minutes):

BASEROW_API_TOKEN=JWT_your_jwt_token_here

Option 3: Database Token

For database-specific operations (limited scope, never expires):

BASEROW_API_TOKEN=Token_your_database_token_here

⚙️ Configuration

MCP Client Setup

1. Open configuration: