Meilisearch MCP 서버

Meilisearch를 위한 MCP(Model Context Protocol) 서버 구현으로, AI 어시스턴트가 표준화된 인터페이스를 통해 Meilisearch와 상호 작용할 수 있습니다.

특징

인덱스 관리 : 인덱스 생성, 업데이트 및 삭제
문서 관리 : 문서 추가, 업데이트 및 삭제
검색 기능 : 다양한 매개변수 및 필터를 사용하여 검색을 수행합니다.
설정 관리 : 인덱스 설정 구성
작업 관리 : 비동기 작업 모니터링 및 관리
시스템 운영 : 상태 점검, 버전 정보 및 통계
벡터 검색 : 실험적 벡터 검색 기능

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Meilisearch MCP Server를 자동으로 설치하려면:

지엑스피1

수동 설치

저장소를 복제합니다.
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp
종속성 설치:
npm install
다음 예를 기반으로 .env 파일을 만듭니다.
cp .env.example .env
.env 파일을 편집하여 Meilisearch 연결을 구성합니다.

도커 설정

Meilisearch MCP 서버는 더 쉬운 배포 및 격리를 위해 Docker 컨테이너에서 실행될 수 있습니다.

Docker Compose 사용

Docker를 시작하는 가장 쉬운 방법은 Docker Compose를 사용하는 것입니다.

# Start the Meilisearch MCP Server
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the server
docker-compose down

Docker 이미지를 수동으로 빌드하고 실행

Docker 이미지를 수동으로 빌드하고 실행할 수도 있습니다.

# Build the Docker image
docker build -t meilisearch-ts-mcp .

# Run the container
docker run -p 3000:3000 --env-file .env meilisearch-ts-mcp

개발 설정

Meilisearch MCP 서버에 기여하고 싶은 개발자를 위해 편리한 설정 스크립트를 제공합니다.

# Clone the repository
git clone https://github.com/devlimelabs-ts-mcp/meilisearch-ts-mcp.git
cd meilisearch-ts-mcp

# Run the development setup script
./scripts/setup-dev.sh

설정 스크립트는 다음을 수행합니다.

.env.example 이 존재하지 않으면 .env 파일을 생성합니다.
종속성 설치
프로젝트를 빌드하세요
모든 것이 제대로 작동하는지 확인하기 위해 테스트를 실행하세요

설치 스크립트를 실행한 후 개발 모드에서 서버를 시작할 수 있습니다.

npm run dev

용법

프로젝트 구축

npm run build

서버 실행

npm start

개발 모드

npm run dev

Claude 데스크톱 통합

Meilisearch MCP 서버는 Claude for Desktop과 통합할 수 있으므로 Claude를 통해 Meilisearch 인스턴스와 직접 상호 작용할 수 있습니다.

자동 설정

Claude for Desktop이 Meilisearch MCP 서버와 함께 작동하도록 자동으로 구성하는 설정 스크립트를 제공합니다.

# First build the project
npm run build

# Then run the setup script
node scripts/claude-desktop-setup.js

스크립트는 다음을 수행합니다.

운영 체제를 감지하고 Claude for Desktop 구성 파일을 찾으세요.
.env 파일에서 Meilisearch 구성을 읽어보세요.
Claude for Desktop에 필요한 구성을 생성합니다.
Claude for Desktop 구성을 업데이트하기 위한 지침을 제공합니다.

수동 설정

데스크톱용 Claude를 수동으로 구성하려면 다음을 수행하세요.

Claude for Desktop 구성 파일을 찾으세요.
- macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
- 윈도우 : %APPDATA%\Claude\claude_desktop_config.json
- 리눅스 : ~/.config/Claude/claude_desktop_config.json
다음 구성을 추가합니다(필요에 따라 경로를 조정합니다):

{
  "mcpServers": {
    "meilisearch": {
      "command": "node",
      "args": ["/path/to/meilisearch-ts-mcp/dist/index.js"],
      "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

변경 사항을 적용하려면 Claude for Desktop을 다시 시작하세요.
Claude에서 "Meilisearch MCP 서버를 사용하고 싶습니다"라고 입력하여 통합을 활성화합니다.

커서 통합

Meilisearch MCP 서버는 AI 기반 코드 편집기인 Cursor 와도 통합될 수 있습니다.

커서에 MCP 설정

Meilisearch MCP 서버를 설치하고 설정하세요.
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp npm install npm run build
MCP 서버를 시작합니다.
npm start
커서에서 명령 팔레트(Cmd/Ctrl+Shift+P)를 열고 "MCP: MCP 서버에 연결"을 검색합니다.
"로컬 MCP 서버에 연결"을 선택하고 다음 세부 정보를 입력합니다.
- 이름 : 메일리서치
- 명령어 : 노드
- 인수 : /absolute/path/to/meilisearch-ts-mcp/dist/index.js
- 환경 변수 :
  MEILISEARCH_HOST=http://localhost:7700 MEILISEARCH_API_KEY=your-api-key
"연결"을 클릭하여 연결을 설정하세요.
이제 "내 Meilisearch 인덱스에서 ...에 대한 문서 검색"과 같은 명령을 입력하여 Cursor를 통해 Meilisearch 인스턴스와 상호 작용할 수 있습니다.

사용 가능한 도구

Meilisearch MCP 서버는 다음과 같은 도구를 제공합니다.

인덱스 도구

create-index : 새로운 인덱스를 생성합니다
get-index : 인덱스에 대한 정보를 가져옵니다.
list-indexes : 모든 인덱스를 나열합니다
update-index : 인덱스 업데이트
delete-index : 인덱스 삭제

문서 도구

add-documents : 인덱스에 문서 추가
get-document : ID로 문서 가져오기
get-documents : 여러 문서 가져오기
update-documents : 문서 업데이트
delete-document : ID로 문서 삭제
delete-documents : 여러 문서 삭제
delete-all-documents : 인덱스의 모든 문서를 삭제합니다.

검색 도구

search : 문서 검색
multi-search : 단일 요청으로 여러 검색을 수행합니다.

설정 도구

get-settings : 인덱스 설정 가져오기
update-settings : 인덱스 설정 업데이트
reset-settings : 인덱스 설정을 기본값으로 재설정합니다.
다양한 특정 설정 도구(동의어, 불용어, 순위 규칙 등)

작업 도구

list-tasks : 선택적 필터링을 사용하여 작업 나열
get-task : 특정 작업에 대한 정보를 가져옵니다.
cancel-tasks : 제공된 필터를 기준으로 작업 취소
wait-for-task : 특정 작업이 완료될 때까지 기다립니다.

시스템 도구

health : Meilisearch 서버의 상태를 확인하세요
version : 버전 정보 가져오기
info : 시스템 정보 가져오기
stats : 인덱스에 대한 통계를 가져옵니다

벡터 도구(실험적)

enable-vector-search : 벡터 검색 활성화
get-experimental-features : 실험적 기능 상태 가져오기
update-embedders : 임베더 구성
get-embedders : embedders 구성 가져오기
reset-embedders : embedders 구성 재설정
vector-search : 벡터 검색을 수행합니다.

특허

MIT

Meilisearch MCP Server

Integrations