Baserow Streamable MCP

Streamable HTTP と Baserow REST API を使用した Baserow 用のリモート MCP サーバーです。

このリポジトリには現在、Phase 1 の技術スパイクが含まれています。意図的にディスカバリと 1 つの書き込み操作のみを公開しており、より広範な CRUD 実装を構築する前に完全な接続パスを検証できるようにしています。

Phase 1 のツール

• list_databases() は、トークンから参照可能なテーブルからアクセス可能なデータベース ID とテーブル数を導出します。Baserow の Database Token ディスカバリエンドポイントがデータベース名を返さないため、データベース名は null になります。

• list_tables() は、Database Token がそのワークスペース内でアクセスできるすべてのテーブルを一覧表示します。

• create_rows(table_id, rows) は、ユーザー向けのフィールド名を使用して最大 200 行を作成します。

Database Token はワークスペーススコープであり、Baserow はトークン固有の全テーブルエンドポイントを公開しています。そのレスポンスには各テーブルの database_id が含まれており、JWT なしでデータベース ID を検出してグループ化できます。データベース名は含まれないため、サーバーは値をでっち上げたり、短命のユーザー認証を要求したりする代わりに name: null を返します。

Phase 1 の Baserow 呼び出しは、次の API 契約に従います:

• GET /api/database/tables/all-tables/ — トークンから参照可能なテーブルの検出用。

• POST /api/database/rows/table/{table_id}/batch/?user_field_names=true — { "items": [...] } を使用したバッチ行作成用。

Related MCP server: AppFlowy Cloud MCP Server

要件

• Node.js 22 以降

• 必要なテーブル権限を持つ Baserow Database Token

ローカルでの実行

cp .env.example .env
# Edit .env, then export it into the shell.
set -a && . ./.env && set +a
npm install
npm run build
npm start

MCP エンドポイントはデフォルトで http://127.0.0.1:3000/mcp です。

Docker Compose での実行

cp .env.example .env
# Edit .env, then start the service.
docker compose up --build -d

Compose の例では、ポートをホストのループバックインターフェースのみに公開しています。同じホストで実行されているリバースプロキシまたはトンネルが HTTPS トラフィックを転送できます。Docker サービス名でセルフホストの Baserow サービスに到達するには、このサービスを同じ外部 Docker ネットワークに接続し、BASEROW_URL を適宜設定します。

リモートアクセスでは、サーバーを HTTPS リバースプロキシまたはトンネルの背後に配置します。Streamable HTTP が MCP トランスポートであり、HTTPS が外部のセキュリティ層です。Phase 1 ではまだ MCP エンドポイント認証を追加していないため、プロキシまたはトンネルでアクセス制御を行わずに公開しないでください。

設定

開発

npm run typecheck
npm test
npm run build

セキュリティ

• .env やトークンをコミットしないでください。

• Baserow トークンは Authorization: Token ... ヘッダーでのみ送信されます。

• サーバーはデフォルトで localhost にバインドします。

• リモートでの本番使用前に HTTPS とエンドポイント認証を設定してください。

ライセンス

MIT