Meilisearch MCP Server

Meilisearch MCP 서버

Claude와 같은 LLM 인터페이스를 통해 Meilisearch와 상호작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

• 인덱스 및 문서 관리
• 설정 구성 및 관리
• 작업 모니터링 및 API 키 관리
• 내장된 로깅 및 모니터링 도구
• Meilisearch 인스턴스 간 전환을 위한 동적 연결 구성
• 단일 또는 여러 인덱스에 대한 스마트 검색
• 이것은 Python 구현이며 브라우저 내에서 Meilisearch MCP 서버로 작업해야 하는 경우 Typescript 통합이 있습니다.

설치

지엑스피1

요구 사항

• 파이썬 ≥ 3.9
• Meilisearch 인스턴스 실행
• Node.js(MCP Inspector로 테스트용)

용법

환경 변수

동적 연결 구성

서버는 런타임에 연결 설정을 보고 업데이트할 수 있는 도구를 제공합니다.

• get-connection-settings : 현재 연결 URL 및 API 키 상태 보기
• update-connection-settings : 다른 Meilisearch 인스턴스에 연결하기 위해 URL 및/또는 API 키를 업데이트합니다.

MCP를 통한 사용 예:

검색 기능

서버는 하나 또는 모든 인덱스를 검색할 수 있는 유연한 검색 도구를 제공합니다.

• search : 선택적 매개변수를 사용하여 Meilisearch 인덱스를 검색합니다.

MCP를 통한 사용 예:

사용 가능한 검색 매개변수:

• query : 검색 쿼리(필수)
• indexUid : 검색할 특정 인덱스(선택 사항)
• limit : 인덱스당 최대 결과 수(선택 사항, 기본값: 20)
• offset : 건너뛸 결과 수(선택 사항, 기본값: 0)
• filter : 필터 표현식(선택 사항)
• sort : 정렬 규칙(선택 사항)

서버 실행

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 claude_desktop_config.json 에 다음을 추가하세요.

MCP Inspector로 테스트

사용 가능한 도구

연결 관리

• get-connection-settings : 현재 Meilisearch 연결 URL 및 API 키 상태 보기
• update-connection-settings : 다른 인스턴스에 연결하기 위해 URL 및/또는 API 키를 업데이트합니다.

인덱스 관리

• create-index : 선택적 기본 키로 새 인덱스를 만듭니다.
• list-indexes : 사용 가능한 모든 인덱스를 나열합니다.
• get-index-metrics : 특정 인덱스에 대한 자세한 메트릭을 가져옵니다.

문서 작업

• get-documents : 페이지 매김을 사용하여 인덱스에서 문서를 검색합니다.
• add-documents : 인덱스에 문서를 추가하거나 업데이트합니다.

찾다

• search : 필터링 및 정렬 옵션을 사용하여 단일 또는 여러 인덱스에 대한 유연한 검색

설정 관리

• get-settings : 인덱스의 현재 설정 보기
• update-settings : 인덱스 설정(순위, 패싯 등)을 업데이트합니다.

API 키 관리

• get-keys : 모든 API 키 나열
• create-key : 특정 권한으로 새로운 API 키 생성
• delete-key : 기존 API 키 삭제

작업 관리

• get-task : 특정 작업에 대한 정보를 가져옵니다.
• get-tasks : 선택적 필터를 사용하여 작업 나열:
  • limit : 반환할 작업의 최대 개수
  • from : 건너뛸 작업 수
  • reverse : 작업 정렬 순서
  • batchUids : 배치 UID로 필터링
  • uids : 작업 UID로 필터링
  • canceledBy : 취소 출처별 필터링
  • types : 작업 유형별 필터링
  • statuses : 작업 상태별 필터링
  • indexUids : 인덱스 UID로 필터링
  • afterEnqueuedAt / beforeEnqueuedAt : 인큐 시간으로 필터링
  • afterStartedAt / beforeStartedAt : 시작 시간으로 필터링
  • afterFinishedAt / beforeFinishedAt : 완료 시간으로 필터링
• cancel-tasks : 보류 중이거나 대기 중인 작업 취소
• delete-tasks : 완료된 작업 삭제

시스템 모니터링

• health-check : 기본 건강 검진
• get-health-status : 종합적인 건강 상태
• get-version : Meilisearch 버전 정보 가져오기
• get-stats : 데이터베이스 통계 가져오기
• get-system-info : 시스템 수준 정보 가져오기

기여하다

1. 포크 저장소
2. 기능 브랜치 생성
3. 변경 사항 커밋
4. 풀 리퀘스트 생성

특허

MIT