local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides sophisticated tools for interacting with PocketBase databases, enabling collection management, record operations (CRUD with relationship support), user authentication, and database backup capabilities.
PocketBase MCP 서버
Dynamics 기반 MCP 서버로, 제가 테스트하고 개선해 온 매우 진행 중인 서버입니다. PocketBase 데이터베이스와 상호 작용할 수 있는 정교한 도구를 제공합니다. 이 서버는 Model Context Protocol(MCP)을 통해 고급 데이터베이스 작업, 스키마 관리 및 데이터 조작을 지원합니다.
왜 이것이고 DynamicsEndpoints가 아닌가?
실제로 최신 버전에서 테스트되었습니다. 현재 PocketBase 26.1 버전이며, Dynamics SDK에 있는 임의적이고 잘못된 정의가 아닌 JS-SDK의 유형 정의를 기반으로 합니다. 많은 메서드가 제대로 작동하지 않습니다.
로컬에서 MCP 서버 설정(현재 지원되는 유일한 방법)
MCP 서버를 로컬로 설정하려면 cline_mcp_settings.json 파일이나 다른 파일(claude, cursor 등)에서 설정해야 합니다. 설정은 동일해 보이지만 저장된 위치만 찾으면 됩니다. 방법은 다음과 같습니다.
cline_mcp_settings.json파일을 찾으세요. 이 파일은 일반적으로 Cursor 사용자 설정 디렉터리에 있습니다. 예:/Users/yourusername/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json- 서버 구성:
cline_mcp_settings.json파일의mcpServers객체에 새 항목을 추가합니다. 키는 서버의 고유한 이름(예: "pocketbase-server")이어야 하고, 값은 서버 구성을 포함하는 객체여야 합니다.지엑스피1command: 서버(보통node)를 시작하는 명령입니다.args: 명령에 전달할 인수 배열입니다. 이 값은 MCP 서버의 컴파일된 JavaScript 파일(예:build/index.js)을 가리켜야 합니다. 경로가 올바른지 확인하세요.env: 환경 변수를 담고 있는 객체.POCKETBASE_URL: PocketBase 인스턴스의 URL입니다. 필수 입니다.POCKETBASE_ADMIN_EMAIL: PocketBase 인스턴스의 관리자 이메일입니다(선택 사항이지만 일부 작업에는 필요함).POCKETBASE_ADMIN_PASSWORD: PocketBase 인스턴스의 관리자 비밀번호입니다(선택 사항이지만 일부 작업에는 필요함).
disabled: 시작 시 서버를 비활성화할지 여부입니다.autoApprove: 자동 승인 도구 목록입니다.- PocketBase 인스턴스 설정과 일치하도록
env객체의 값을 조정합니다.
- 서버 시작:
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: 사용자 정의 데이터 디렉토리 경로
사용 예
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 커밋하세요
- 지점으로 밀어 넣기
- 풀 리퀘스트 만들기
This server cannot be installed
PocketBase 데이터베이스와 상호 작용하기 위한 정교한 도구를 제공하여 고급 데이터베이스 작업, 스키마 관리, MCP(Model Context Protocol)를 통한 데이터 조작을 가능하게 합니다.