butterbase-ai/butterbase

Butterbase

오픈소스 백엔드-서비스(BaaS). Postgres, 인증, 스토리지, 함수, AI 게이트웨이, MCP를 제공합니다.

기능

• Postgres 데이터베이스 – 완전 관리형 Postgres 데이터베이스로, 스키마 마이그레이션, 백업, 확장을 지원합니다.
• 인증 – 이메일/비밀번호, OAuth(Google, GitHub 등), JWT 기반 인증을 내장하고 있습니다.
• 스토리지 – 파일 업로드/다운로드, 이미지 변환, CDN 캐싱을 지원하는 객체 스토리지입니다.
• 서버리스 함수 – TypeScript/JavaScript로 서버리스 함수를 작성하고 HTTP 엔드포인트로 배포할 수 있습니다.
• AI 게이트웨이 – OpenAI, Anthropic, Google AI 등 여러 LLM 제공업체에 대한 통합 API 게이트웨이입니다.
• MCP(Model Context Protocol) – AI 에이전트가 데이터베이스, 스토리지, 함수와 상호작용할 수 있도록 MCP 서버를 제공합니다.

설치

로컬 개발

# 저장소 클론
git clone https://github.com/butterbase-ai/butterbase.git
cd butterbase

# 의존성 설치
npm install

# 환경 변수 설정
cp.env.example.env
#.env 파일을 편집하여 Postgres 연결 문자열, JWT 시크릿 등을 설정하세요.

# 데이터베이스 마이그레이션 실행
npm run db:migrate

# 개발 서버 시작
npm run dev

Docker

docker compose up -d

사용법

데이터베이스

Butterbase는 Postgres 데이터베이스에 대한 RESTful API를 제공합니다. 테이블을 생성하고, 쿼리하고, 관계를 정의할 수 있습니다.

// 예: 클라이언트에서 데이터 가져오기
const response = await fetch('http://localhost:3000/api/rest/v1/users', {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});
const users = await response.json();

인증

// 회원가입
await fetch('http://localhost:3000/api/auth/v1/signup', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: '[email protected]', password: 'password123' })
});

서버리스 함수

functions/ 디렉토리에 함수를 생성합니다:

// functions/hello.ts
export default async (req: Request) => {
  return new Response('Hello, Butterbase!', { status: 200 });
};

AI 게이트웨이

const response = await fetch('http://localhost:3000/api/ai/v1/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify({
    provider: 'openai',
    model: 'gpt-4',
    messages: [{ role: 'user', content: 'Hello' }]
  })
});

MCP

Butterbase는 MCP 서버를 제공하여 AI 에이전트가 데이터베이스와 상호작용할 수 있도록 합니다. MCP 클라이언트(예: Claude Desktop)에서 다음 설정을 추가하세요:

{
  "mcpServers": {
    "butterbase": {
      "command": "npx",
      "args": ["-y", "@butterbase/mcp-server"],
      "env": {
        "BUTTERBASE_URL": "http://localhost:3000",
        "BUTTERBASE_API_KEY": "your-api-key"
      }
    }
  }
}

구성

환경 변수(.env)를 통해 구성합니다:

• DATABASE_URL – Postgres 연결 문자열
• JWT_SECRET – JWT 서명용 시크릿
• STORAGE_BUCKET – 스토리지 버킷 이름
• AIPROVIDERAPI_KEY – AI 게이트웨이용 API 키

API 참조

전체 API 문서는 https://docs.butterbase.io에서 확인할 수 있습니다.

아키텍처

Butterbase는 모듈식 아키텍처로 설계되었습니다:

• API 게이트웨이 – 모든 요청을 적절한 서비스로 라우팅합니다.
• 인증 서비스 – 사용자 인증 및 권한 부여를 처리합니다.
• 데이터베이스 서비스 – Postgres와 상호작용합니다.
• 스토리지 서비스 – 파일 저장 및 검색을 관리합니다.
• 함수 서비스 – 서버리스 함수를 실행합니다.
• AI 게이트웨이 – LLM 제공업체에 대한 요청을 프록시합니다.
• MCP 서버 – AI 에이전트가 시스템과 상호작용할 수 있도록 합니다.