remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides a Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces, supporting index and document management, settings configuration, task monitoring, API key management, and search capabilities across single or multiple indices.

Meilisearch MCP 서버

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

특징

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

설치

지엑스피1

요구 사항

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

용법

환경 변수

MEILI_HTTP_ADDR=http://localhost:7700  # Default Meilisearch URL
MEILI_MASTER_KEY=your_master_key       # Optional: Default Meilisearch API key

동적 연결 구성

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

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

MCP를 통한 사용 예:

// Get current settings
{
  "name": "get-connection-settings"
}

// Update connection settings
{
  "name": "update-connection-settings",
  "arguments": {
    "url": "http://new-host:7700",
    "api_key": "new-api-key"
  }
}

검색 기능

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

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

MCP를 통한 사용 예:

// Search in a specific index
{
  "name": "search",
  "arguments": {
    "query": "search term",
    "indexUid": "movies",
    "limit": 10
  }
}

// Search across all indices
{
  "name": "search",
  "arguments": {
    "query": "search term",
    "limit": 5,
    "sort": ["releaseDate:desc"]
  }
}

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

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

서버 실행

python -m src.meilisearch_mcp

Claude Desktop과 함께 사용

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

{
  "mcpServers": {
    "meilisearch": {
      "command": "uvx",
      "args": ["-n", "meilisearch-mcp"]
    }
  }
}

MCP Inspector로 테스트

npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

사용 가능한 도구

연결 관리

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 : 시스템 수준 정보 가져오기

기여하다

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

특허

MIT

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Claude와 같은 LLM 인터페이스를 통해 Meilisearch 와 상호작용하기 위한 서버입니다.

Meilisearch MCP Server