Baserow Streamable MCP

Streamable HTTP와 Baserow REST API를 사용하는 Baserow용 원격 MCP 서버입니다.

이 저장소에는 현재 Phase 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/

• { "items": [...] }를 사용한 배치 행 생성용 POST /api/database/rows/table/{table_id}/batch/?user_field_names=true

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