InstantDB MCP Server

instantdb-server MCP 서버

InstantDB와 상호작용하기 위한 MCP 서버.

이 서버는 동적으로 로드된 스키마와 환경 구성을 사용하여 InstantDB를 쿼리하기 위한 읽기 전용 인터페이스를 제공합니다. 사전 정의된 패턴을 기반으로 쿼리를 실행하고 쿼리 예제를 검색하는 도구가 포함되어 있습니다.

특징

도구

• get_examples
  다양한 카테고리(예: "basic_read", "filtering", "associations")에 대한 미리 정의된 예제 쿼리를 반환합니다.
• 쿼리DB
  InstantDB에 대해 특정 쿼리를 실행합니다. 쿼리와 설명적인 이름 매개변수가 필요합니다.
• 목록_쿼리
  쿼리 ID, 이름, 타임스탬프, 구조 등의 세부 정보와 함께 실행된 쿼리의 기록을 검색합니다.
• 반환_쿼리
  나중에 참조하거나 구현할 수 있도록 고유 ID로 특정 쿼리를 검색합니다.

스키마 및 환경 통합

• 제공된 프로젝트 디렉토리(예: instant.schema.ts, src/instant.schema.ts, app/instant.schema.ts)를 기준으로 공통 파일 위치에서 InstantDB 스키마를 동적으로 로드합니다.
• 환경 변수 구성은 프로젝트의 .env 파일에서 로드됩니다. 필수 변수는 다음과 같습니다.
  • 인스턴트 앱 ID
  • 인스턴트 앱 관리자 토큰

보류 중인 기능

• 일반적인 파일 위치에서 InstantDB 권한 파일을 동적으로 감지합니다.

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude Desktop과 함께 서버를 사용하려면 Claude Desktop 설정에 다음 구성을 추가하세요.

macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

구성 예:

디버깅

MCP 서버 통신을 디버깅하려면 MCP Inspector를 사용하세요.

검사관은 MCP 서버 작업을 모니터링하는 도구에 액세스할 수 있는 URL을 제공합니다.