PocketBase MCP 서버

Dynamics 기반 MCP 서버로, 제가 테스트하고 개선해 온 매우 진행 중인 서버입니다. PocketBase 데이터베이스와 상호 작용할 수 있는 정교한 도구를 제공합니다. 이 서버는 Model Context Protocol(MCP)을 통해 고급 데이터베이스 작업, 스키마 관리 및 데이터 조작을 지원합니다.

왜 이것이고 DynamicsEndpoints가 아닌가?

실제로 최신 버전에서 테스트되었습니다. 현재 PocketBase 26.1 버전이며, Dynamics SDK에 있는 임의적이고 잘못된 정의가 아닌 JS-SDK의 유형 정의를 기반으로 합니다. 많은 메서드가 제대로 작동하지 않습니다.

Related MCP server: Xano MCP Server

로컬에서 MCP 서버 설정(현재 지원되는 유일한 방법)

MCP 서버를 로컬로 설정하려면 cline_mcp_settings.json 파일이나 다른 파일(claude, cursor 등)에서 설정해야 합니다. 설정은 동일해 보이지만 저장된 위치만 찾으면 됩니다. 방법은 다음과 같습니다.

1. cline_mcp_settings.json 파일을 찾으세요. 이 파일은 일반적으로 Cursor 사용자 설정 디렉터리에 있습니다. 예: /Users/yourusername/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. 서버 구성: cline_mcp_settings.json 파일의 mcpServers 객체에 새 항목을 추가합니다. 키는 서버의 고유한 이름(예: "pocketbase-server")이어야 하고, 값은 서버 구성을 포함하는 객체여야 합니다.

   지엑스피1

   • command : 서버(보통 node )를 시작하는 명령입니다.

   • args : 명령에 전달할 인수 배열입니다. 이 값은 MCP 서버의 컴파일된 JavaScript 파일(예: build/index.js )을 가리켜야 합니다. 경로가 올바른지 확인하세요.

   • env : 환경 변수를 담고 있는 객체.

     • POCKETBASE_URL : PocketBase 인스턴스의 URL입니다. 필수 입니다.

     • POCKETBASE_ADMIN_EMAIL : PocketBase 인스턴스의 관리자 이메일입니다(선택 사항이지만 일부 작업에는 필요함).

     • POCKETBASE_ADMIN_PASSWORD : PocketBase 인스턴스의 관리자 비밀번호입니다(선택 사항이지만 일부 작업에는 필요함).

   • disabled : 시작 시 서버를 비활성화할지 여부입니다.

   • autoApprove : 자동 승인 도구 목록입니다.

   • PocketBase 인스턴스 설정과 일치하도록 env 객체의 값을 조정합니다.

3. 서버 시작: cline_mcp_settings.json 파일을 구성한 후 구성된 도구로 MCP 서버를 사용할 수 있습니다.

특징

컬렉션 관리

• 사용자 정의 스키마를 사용하여 컬렉션을 만들고 관리합니다.

• 컬렉션 스키마 및 메타데이터 검색

기록 작업

• 레코드에 대한 CRUD 작업

• 관계 확장 지원

• 페이지 매김 및 커서 기반 탐색

사용자 관리

• 사용자 인증 및 토큰 관리

• 사용자 계정 생성 및 관리

• 비밀번호 관리

데이터베이스 작업

• 데이터베이스 백업

사용 가능한 도구

컬렉션 관리

• create_collection : 사용자 정의 스키마를 사용하여 새 컬렉션을 만듭니다.

• get_collection : 컬렉션에 대한 스키마 세부 정보를 가져옵니다.

기록 작업

• create_record : 컬렉션에 새 레코드를 만듭니다.

• list_records : 선택적 필터와 페이지 매김을 사용하여 레코드를 나열합니다.

• update_record : 기존 레코드를 업데이트합니다

• delete_record : 레코드 삭제

사용자 관리

• authenticate_user : 사용자를 인증하고 인증 토큰을 얻습니다.

• create_user : 새로운 사용자 계정을 생성합니다

데이터베이스 작업

• backup_database : 포맷 옵션을 사용하여 PocketBase 데이터베이스의 백업을 생성합니다.

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• POCKETBASE_URL : PocketBase 인스턴스의 URL(예: " http://127.0.0.1:8090 ")

선택적 환경 변수:

• POCKETBASE_ADMIN_EMAIL : 특정 작업에 대한 관리자 이메일

• POCKETBASE_ADMIN_PASSWORD : 관리자 비밀번호

• POCKETBASE_DATA_DIR : 사용자 정의 데이터 디렉토리 경로

사용 예

// Create a new collection
await mcp.use_tool("pocketbase", "create_collection", {
  name: "posts",
  schema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    }
  ]
});

// Authenticate with password
await mcp.use_tool("pocketbase", "authenticate_user", {
  email: "user@example.com",
  password: "securepassword",
  collection: "users"
});

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항을 커밋하세요

4. 지점으로 밀어 넣기

5. 풀 리퀘스트 만들기