Baserow Streamable MCP

Удалённый MCP-сервер для Baserow, использующий Streamable HTTP и REST API Baserow.

В этом репозитории сейчас находится технический спайк Phase 1. Он намеренно предоставляет только обнаружение и одну операцию записи, чтобы проверить полный путь подключения до создания более широкой реализации CRUD.

Инструменты Phase 1

• list_databases() получает доступные идентификаторы баз данных и количество таблиц из таблиц, видимых токену. Имена баз данных равны null, потому что эндпоинт обнаружения Database Token в Baserow их не возвращает.

• list_tables() выводит список всех таблиц, доступных Database Token в его рабочем пространстве.

• create_rows(table_id, rows) создаёт до 200 строк, используя имена полей, видимые пользователю.

Database Tokens имеют область действия в пределах рабочего пространства, и Baserow предоставляет специфичный для токена эндпоинт all-tables. Его ответ содержит database_id для каждой таблицы, что позволяет находить и группировать идентификаторы баз данных без JWT. Имена баз данных в ответ не включены, поэтому сервер возвращает 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 или новее.

• Database Token Baserow с требуемыми правами на таблицы.

Запуск локально

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 публикует порт только на loopback-интерфейсе хоста. Обратный прокси или туннель на том же хосте может перенаправлять на него HTTPS-трафик. Чтобы подключаться к self-hosted сервису Baserow по имени Docker-сервиса, добавьте этот сервис к той же внешней 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