Baserow Streamable MCP

Un servidor MCP remoto para Baserow que utiliza Streamable HTTP y la API REST de Baserow.

Este repositorio contiene actualmente el spike técnico de la Fase 1. Expone intencionalmente solo el descubrimiento y una operación de escritura para que se pueda validar la ruta de conexión completa antes de que se construya la implementación CRUD más amplia.

Herramientas de la Fase 1

• list_databases() deriva los IDs de bases de datos accesibles y los recuentos de tablas a partir de las tablas visibles para el token. Los nombres de las bases de datos son null porque el endpoint de descubrimiento de Database Token de Baserow no los devuelve.

• list_tables() enumera todas las tablas accesibles para el Database Token en su espacio de trabajo.

• create_rows(table_id, rows) crea hasta 200 filas utilizando nombres de campos visibles para el usuario.

Los Database Tokens están limitados al espacio de trabajo y Baserow expone un endpoint de todas las tablas específico para el token. Su respuesta contiene el database_id de cada tabla, lo que permite descubrir y agrupar los IDs de bases de datos sin un JWT. No incluye los nombres de las bases de datos, por lo que el servidor devuelve name: null en lugar de inventar un valor o requerir autenticación de usuario de corta duración.

Las llamadas a Baserow de la Fase 1 siguen estos contratos de API:

• GET /api/database/tables/all-tables/ para el descubrimiento de tablas visibles para el token.

• POST /api/database/rows/table/{table_id}/batch/?user_field_names=true con { "items": [...] } para la creación de filas por lotes.

Related MCP server: AppFlowy Cloud MCP Server

Requisitos

• Node.js 22 o posterior

• Un Database Token de Baserow con los permisos de tabla necesarios

Ejecutar localmente

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

El endpoint MCP es http://127.0.0.1:3000/mcp por defecto.

Ejecutar con Docker Compose

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

El ejemplo de Compose publica el puerto solo en la interfaz de bucle local del host. Un proxy inverso o túnel que se ejecute en el mismo host puede reenviar tráfico HTTPS hacia él. Para alcanzar un servicio de Baserow autoalojado por nombre de servicio de Docker, conecte este servicio a la misma red Docker externa y configure BASEROW_URL en consecuencia.

Para el acceso remoto, coloque el servidor detrás de un proxy inverso o túnel HTTPS. Streamable HTTP es el transporte MCP; HTTPS es la capa de seguridad externa. La Fase 1 aún no añade autenticación al endpoint MCP, por lo que no lo exponga públicamente sin control de acceso en el proxy o túnel.

Configuración

Desarrollo

npm run typecheck
npm test
npm run build

Seguridad

• Nunca haga commit de .env ni de tokens.

• El token de Baserow se envía únicamente en la cabecera Authorization: Token ....

• El servidor se vincula a localhost por defecto.

• Configure HTTPS y la autenticación del endpoint antes de usarlo en producción de forma remota.

Licencia

MIT