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 권한 파일을 동적으로 감지합니다.

Related MCP server: mysql-mcp-server

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

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

npm run watch

설치

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

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

구성 예:

{
  "mcpServers": {
    "instantdb-server": {
      "command": "node",
      "args": ["/path/to/instantdb-server/build/index.js"],
      "env": {
        "INSTANT_APP_ID": "your_app_id",
        "INSTANT_APP_ADMIN_TOKEN": "your_admin_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

디버깅

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

npm run inspector

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