Typesense MCP 서버

AI 모델에 Typesense 검색 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 LLM은 Typesense 컬렉션에 저장된 데이터를 검색하고 분석할 수 있습니다.

데모

특징

자원

• typesense:// URI를 통해 컬렉션을 나열하고 액세스합니다.
• 각 컬렉션에는 이름, 설명 및 문서 수가 있습니다.
• 스키마 액세스를 위한 JSON MIME 유형

도구

• 타입센스_쿼리
  • 강력한 필터링을 통해 Typesense 컬렉션에서 문서를 검색하세요
  • 입력: 쿼리 텍스트, 컬렉션 이름, 검색 필드, 필터, 정렬 옵션, 제한
  • 관련성 점수와 일치하는 문서를 반환합니다.
• 타입센스_겟_문서
  • 컬렉션에서 ID로 특정 문서 검색
  • 입력: 컬렉션 이름, 문서 ID
  • 전체 문서 데이터를 반환합니다.
• 타입센스_컬렉션_통계
  • Typesense 컬렉션에 대한 통계 가져오기
  • 입력: 컬렉션 이름
  • 컬렉션 메타데이터, 문서 수 및 스키마 정보를 반환합니다.

프롬프트

• 분석_수집
  • 컬렉션 구조 및 내용 분석
  • 입력: 컬렉션 이름
  • 출력: 스키마, 데이터 유형 및 통계에 대한 통찰력
• 검색 제안
  • 컬렉션에 대한 효과적인 검색 쿼리에 대한 제안을 받으세요
  • 입력: 컬렉션 이름
  • 출력: 컬렉션 스키마를 기반으로 한 권장 검색 전략

설치

npm을 통해

지엑스피1

mcp-get을 통해

개발

종속성 설치:

서버를 빌드하세요:

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

개발을 위한 설치

Claude Desktop 사용

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

구성 요소

자원

서버는 Typesense 컬렉션에 대한 정보를 제공합니다.

• 컬렉션 스키마 ( typesense://collections/<collection> )
  • 각 컬렉션에 대한 JSON 스키마 정보
  • 필드 이름과 데이터 유형이 포함됩니다.
  • 데이터 구조를 이해하기 위한 샘플 문서

리소스 템플릿

서버는 다음에 대한 템플릿을 제공합니다.

• typesense_search - Typesense 검색 쿼리를 구성하기 위한 템플릿
• typesense_collection - Typesense 컬렉션 세부 정보를 보기 위한 템플릿

Claude Desktop과 함께 사용

Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.

벌채 반출

서버는 다음 위치에 있는 파일에 정보를 기록합니다.

이 로그에는 서버 작업, 요청 및 발생하는 오류에 대한 자세한 정보가 포함되어 있습니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.