Baserow MCP Server

Baserow MCP サーバー

MCP 互換クライアント（Claude Desktop、Cursor、Windsurf など）と Baserow をシームレスに連携させる MCP（Model Context Protocol）サーバーです。自然言語による AI 活用型のデータベース操作を実現します。

🚀 特長

• 🔐 スマート認証：認証情報または手動の JWT／データベーストークンによる自動トークン更新
• 🏢 ワークスペース管理：Baserow ワークスペースの一覧表示、作成、管理
• 🗄️ データベース操作：ワークスペース内のデータベースを完全に管理
• 📊 テーブル管理：フィールド定義を含むテーブルの作成、一覧表示、管理
• 📝 行の CRUD 操作：作成、読み取り、更新、削除のすべての機能
• ⚡ 一括操作：行の作成、更新、削除を効率的に一括実行
• 🔍 高度なクエリ：ページネーション、フィルタリング、並べ替えに対応
• 💡 自然言語：平易な英語でデータベースを操作

📋 前提条件

• Node.js v22+（nvm からインストール）
• MCP 互換クライアント：
  • Claude Desktop
  • Cursor
  • Windsurf
  • その他の MCP 互換 AI エディター
• Baserow アカウント（セルフホストまたはクラウド）

🛠️ インストール

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

   npm install
   

3. 認証を設定します：

   cp .env.example .env
   

   .env を編集し、認証情報を追加します：

   # 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. プロジェクトをビルドします：

   npm run build
   

🔑 認証方法

方法 1：ユーザー名／パスワード（推奨）

自動トークン更新と API への完全なアクセスが可能です：

[email protected]
BASEROW_PASSWORD=your_password

方法 2：JWT トークン

手動でトークンを管理する場合に使用します（60 分後に有効期限が切れます）：

BASEROW_API_TOKEN=JWT_your_jwt_token_here

方法 3：データベーストークン

データベース固有の操作に使用します（適用範囲が限定され、有効期限はありません）：

BASEROW_API_TOKEN=Token_your_database_token_here

⚙️ 設定

MCP クライアントの設定

Claude Desktop

1. 設定ファイルを開きます：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

2. Baserow サーバーを追加します：

   {
     "mcpServers": {
       "baserow": {
         "command": "/path/to/mcp-baserow/start.sh"
       }
     }
   }
   

Cursor

1. Cursor の設定を開きます
2. MCP Servers セクションに移動します
3. 次を追加します：

   {
     "baserow": {
       "command": "/path/to/mcp-baserow/start.sh"
     }
   }
   

Windsurf

1. Windsurf の設定を開きます
2. MCP サーバーに次を追加します：

   {
     "baserow": {
       "command": "/path/to/mcp-baserow/start.sh"
     }
   }
   

3. MCP クライアントを再起動します

📚 使用例

自然言語コマンド

設定後、MCP クライアントで自然言語を使用できます：

• 「Baserow のワークスペースをすべて表示して」
• 「ワークスペースに『Project Tracker』という新しいデータベースを作成して」
• 「Project Tracker データベース内のテーブルをすべて一覧表示して」
• 「Tasks テーブルに、タイトルが『Review PR』、ステータスが『In Progress』の新しい行を追加して」
• 「Tasks テーブルの 5 行目を更新して、完了済みにして」
• 「Archive テーブルで、30 日より前の行をすべて削除して」

利用可能な MCP ツール

認証ツール（3）

• baserow_auth_status - 認証ステータスと機能を確認します
• baserow_auth_login - 認証情報でログインします
• baserow_auth_set_token - JWT またはデータベーストークンを手動で設定します

ワークスペースツール（4）

• baserow_list_workspaces - すべてのワークスペースを一覧表示します
• baserow_get_workspace - ワークスペースの詳細を取得します
• baserow_create_workspace - 新しいワークスペースを作成します
• baserow_set_workspace - 操作対象のアクティブなワークスペースを設定します

データベースツール（3）

• baserow_list_databases - ワークスペース内のデータベースを一覧表示します
• baserow_get_database - データベースの詳細を取得します
• baserow_create_database - 新しいデータベースを作成します

テーブルツール（3）

• baserow_list_tables - データベース内のテーブルを一覧表示します
• baserow_get_table - フィールド定義とともにテーブルを取得します
• baserow_create_table - 新しいテーブルを作成します

行操作（8）

• baserow_list_rows - ページネーション／フィルタリングを使用して行を一覧表示します
• baserow_get_row - ID で単一の行を取得します
• baserow_create_row - 新しい行を作成します
• baserow_update_row - 既存の行を更新します
• baserow_delete_row - 行を削除します
• baserow_batch_create_rows - 複数の行を作成します
• baserow_batch_update_rows - 複数の行を更新します
• baserow_batch_delete_rows - 複数の行を削除します

🧪 開発

開発環境のセットアップ

# Install dependencies
npm install

# Run TypeScript compiler in watch mode
npm run dev

# Run tests (when available)
npm test

プロジェクト構成

mcp-baserow/
├── src/
│   ├── index.ts          # MCP server entry point
│   ├── auth-manager.ts   # Authentication handling
│   ├── baserow-client.ts # Baserow API client
│   ├── tools/           # MCP tool implementations
│   │   ├── auth.ts      # Authentication tools
│   │   ├── workspace.ts # Workspace operations
│   │   ├── database.ts  # Database operations
│   │   ├── table.ts     # Table operations
│   │   └── row.ts       # Row CRUD operations
│   └── types/           # TypeScript type definitions
├── dist/                # Compiled JavaScript
├── examples/            # Usage examples
└── tests/              # Test files

🤝 コントリビューション

コントリビューションを歓迎します！詳細は、コントリビューションガイドラインをご覧ください。

コントリビューター向けクイックスタート

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

📝 変更履歴

各バージョンの変更一覧は、CHANGELOG.mdをご覧ください。

🐛 トラブルシューティング

よくある問題

1. 「認証に失敗しました」

   • .env 内の認証情報を確認してください
   • Baserow アカウントが有効であることを確認してください
   • 正しい API URL を使用しているか確認してください

2. 「workspace_id が指定されていません」

   • baserow_set_workspace を使用してアクティブなワークスペースを設定してください
   • または、データベース操作で workspace_id パラメーターを指定してください

3. 「サーバーが切断されました」

   • MCP クライアントのログを確認してください：
     • Claude Desktop：~/Library/Logs/Claude/mcp-server-baserow.log
     • その他のクライアント：それぞれのログ保存場所を確認してください
   • Node.js v22+ がインストールされていることを確認してください
   • すべての依存関係がインストールされていることを確認してください

デバッグモード

次を設定してデバッグログを有効にします：

export DEBUG=baserow:*

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• MCP 仕様を提供してくださった Anthropic
• 優れたオープンソースのデータベースプラットフォームを提供してくださった Baserow
• サンプルやベストプラクティスを共有してくださった MCP コミュニティ

🔗 リンク

• MCP ドキュメント
• Baserow API ドキュメント
• 問題を報告

---

オープンソースコミュニティの ❤️ を込めて作成