Baserow Streamable MCP

一个用于 Baserow 的远程 MCP 服务器，使用 Streamable HTTP 和 Baserow REST API。

此仓库目前包含第一阶段技术验证。它有意只暴露发现操作和一个写入操作，以便在构建更全面的 CRUD 实现之前验证完整的连接路径。

第一阶段工具

• list_databases() 从令牌可见的表中推导出可访问的数据库 ID 和表数量。数据库名称为 null，因为 Baserow 的 Database Token 发现端点不返回它们。

• list_tables() 列出 Database Token 在其工作区中可访问的每个表。

• create_rows(table_id, rows) 使用面向用户的字段名称创建最多 200 行。

Database Token 是工作区范围的，Baserow 暴露了一个特定于令牌的 all-tables 端点。其响应包含每个表的 database_id，从而无需 JWT 即可发现和分组数据库 ID。它不包含数据库名称，因此服务器返回 name: null，而不是凭空捏造一个值或要求短时用户认证。

第一阶段 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 是外部安全层。第一阶段尚未添加 MCP 端点认证，因此如果没有在代理或隧道处进行访问控制，请勿将其公开暴露。

配置

开发

npm run typecheck
npm test
npm run build

安全

• 切勿提交 .env 或令牌。

• Baserow 令牌仅通过 Authorization: Token ... 请求头发送。

• 服务器默认绑定到 localhost。

• 在远程生产环境使用之前，配置 HTTPS 和端点认证。

许可证

MIT